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ME A 


来 源 : http://www.worldhello.net/gotgithub/index.html 作者 : :& £& 
动笔 写 GitHub 不 是 因为 我 对 其 了 解 ， 恰 恰 是 对 其 太 不 了 解 。 


在 我 的 《Git 权 威 指南 》 [1] 一 书 中 ， 涉 及 到 GitHub 的 只 有 区 区 三 这 显然 回答 不 了 读者 
对 于 GitHub 的 诸 乡 疑问 。 记 得 在 《Git 权 威 指南 》 刚 刚 完 稿 之 际 ， pedes 出 版 社 华章 公司 的 
杨 福 川 编辑 就 鼓动 我 写 一 本 关于 GitHub 的 书 ， 我 用 了 好 多 理由 推荐 了 。 X CREE SLE AUR) 
系 着 了 。 在 每 一 章节 开始 动笔 之 时 ， 都 好 像 是 坐 在 了 中 学 语文 考试 的 考 堂 上 写作 文 ， 时 间 快 

到 了 可 仍然 动 不 了 笔 ， 再 写 一 本 书 无 疑 要 重复 这 一 痛 关 的 经 历 。 第 二 个 理由 是 我 更 喜欢 编 

程 ， 而 不 是 写 文档 ， 尤 其 写 GitHub 会 有 大 量 截 图 、 图 像 处 理 的 琐碎 工作 。 第 三 个 理由 彻底 让 
编辑 投降 ， 那 就 是 GitHub 是 一 个 国外 网 站 ， 也 许 书 一 出 ，【 此 名 已 被 原作 者 删除 】 


让 我 最 终 决 定 动笔 ， 是 源 于 CSDN 将 总 在 美国 拜访 GitHub 总 部 后 告诉 我 的 一 些 见 闻 ， 我 对 
GitHub 如 此 成 功 运 作 产 生 了 兴趣 ， 于 是 开始 研究 GitHub 的 博客 ， 人 钝 发 发 现 GitHub 是 一 群 有 趣 
的 人 在 做 的 有 趣 的 事 ， 如 果 只 把 GitHub 当 作 一 个 Git 服 务 器 ， 实 在 是 暴 珍 天 物 。GitHub 已 经 并 
将 继续 获得 成 功 ， 若 真能 凭借 此 书 把 GitHub 尺 量 全 面 地 展现 ， 让 每 一 个 Git 使 用 者 用 好 GitHub 
也 是 一 件 痒 事 。 


这 本 书 将 采用 GitHub 的 方式 进行 撰写 和 发 布 [2]， 任 何人 都 可 以 看 到 本 书 (包括 源码 ) ， 更 可 
以 用 GitHub 的 方法 参与 本 书 的 撰写 和 纠 错 。 网 络 出 版 对 于 我 和 杨 福 川 编 辑 都 是 一 个 全 新 的 体 
验 。 感 谢 Git， 让 我 在 一 年 内 拥有 了 两 种 不 同 的 出 版 体验 。 


-薪金 , 2011.12 


1. 4& € GitHub 


熟悉 Git 的 人 几乎 都 知道 并 喜欢 GitHub， 反 过 来 GitHub 也 吸引 更 多 的 人 来 使 用 Git。GitHub 正 在 
成 为 开源 项 目 托管 的 主要 平台 ， 是 什么 成 就 了 GitHub ? 


也 可 以 参考 : 


本 书 并 非 一 本 介绍 Git 的 书 ， 并 且 假 设 读 者 已 经 掌握 了 Git 的 相关 操作 。 如 果 读 者 对 Git 尚 
不 了 解 ， 可 以 参考 我 写 的 [《Git 权 威 指南 》] [ 注 1] 一 书 。 此 外 还 可 以 从 网 上 找到 很 多 免费 
的 、 很 好 的 Git 资 料 ， 如 : Git 社 区 书 、Pro Git o 


[ 注 1]: ISBN : 9787111349679, 由 机 械 工 业 出 版 社 华章 公司 于 2011 年 7 月 出 版 。 
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1.1. 什么 是 GitHub 


GitHub (网 址 https://github.com/) 是 一 个 面向 开源 及 私有 软件 项 目的 托管 平台 ， 因 为 只 支持 
Git 作 为 唯一 的 版 本 库 格 式 进行 托管 ， 故 名 GitHub。 


GitHub 的 注册 用 户 已 经 超过 百 万 [1]， 托 管 的 版 本 库 数 量 已 超 三 百 万 ， 其 中 不 乏 知 名 的 开源 项 
目 ， 如 : Ruby on Rails[2] > Hibernate[3] ` phpBB[4] ` jQuery[5] > Prototype[6] ` 
Homebrew[7]# » 


GitHub 于 2008 年 4 月 10 日 正式 发 布 [8]， 相 比 始 于 1999 年 的 SourceForge[9] 和 2005 年 的 


GoogleCode[10]，GitHub 后 来 者 居 上 。 以 2011 年 的 数据 从 代码 提交 数量 上 看 ，GitHub 已 经 超 
越 其 前 莫 [11]， 如 图 1-1 所 示 。 
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El 1-1 : 开源 项 目 托管 平台 提交 数量 对 照 


对 于 一 个 开源 项 目 ， 从 开发 角度 讲 大 体 上 分 为 两 类 人 群 ， 一 类 称 为 核心 开发 团队 ， 他 们 可 以 
向 保存 源 代 码 的 版 本 库 提 交 ， 即 对 源 代 码 的 修改 具有 最 终 的 决定 权 。 另 外 一 类 称 为 贡献 者 ， 
他 们 不 属于 核心 开发 团队 ， 虽 然 也 能 看 到 源 代码 ， 但 无 权 向 版 本 库 提 交 修 改 。 


采用 传统 的 集中 式 版 本 控制 系统 (如 SVN) 的 开源 项 目 ， 这 两 个 群体 的 用 户 体验 都 不 是 太 
好 。 如 图 1-2 所 示 ， 项 目的 贡献 者 ( 非 核心 成 员 ) 很 不 高兴”， 因 为 他 们 即便 有 修改 源 代码 的 
能 力 和 渴望 ， 也 不 能 直接 向 版 本 库 提交 ， 要 想 成 为 提交 者 需要 一 个 很 长 的 建立 信任 的 过 程 。 
然而 即便 是 核心 开发 团队 的 成 员 ， 体 验 也 不 是 太 好 ， 因 为 凡是 涉及 到 版 本 库 的 操作 ( 检 入 、 
检 出 、 查 看 日 志 等 ) 都 需要 在 联网 的 状态 下 进行 ， 网 络 带 宽 对 用 户 体验 影响 相当 大 。 


O) 
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图 1-2 : 使 用 集中 式 版 本 控制 系统 


Git 等 分 布 式 版 本 控制 系统 的 出 现 ， 彻 底 颠 履 了 原 有 代码 管理 的 组 织 模式 。 使 用 Git， 不 再 依赖 
唯一 的 、 集 中 式 的 版 本 库 ， 而 是 每 个 开发 者 本 地 都 拥有 一 份 完 整 的 版 本 库 。Git 并 不 排斥 集中 
式 的 使 用 模式 ， 但 更 倾向 于 将 集中 式 版 本 库 称 为 共享 版 本 库 。 核 心 开发 团队 的 成 员 和 贡献 者 
( 非 核 心 成 员 ) 都 可 以 从 共享 版 本 库 克 隆 一 份 本 地 版 本 库 ， 但 只 有 核心 团队 成 员 才 可 以 将 自 
已 本 地 版 本 库 的 提交 推送 到 共享 版 本 库 上 。 如 图 1-3 所 示 。 
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El 1-3 : 使 用 分 布 式 版 本 控制 系统 


1.1. 什么 是 GitHub 


使 用 Git 做 版 本 控制 (如 图 1-3 所 示 ) ， 核 心 开 发 团队 非常 “高 兴 ”， 因 为 他 们 和 共享 版 本 库 之 间 
不 必 一 直 保 持 连 接 状 态 ， 诸 如 查看 日 志 、 提 交 、 创 建 分 支 等 几乎 全 部 操作 都 〈 脱 离 网 络 ) 在 

本 地 的 版 本 库 中 完成 。 项 目 贡 献 者 〈 非 核心 成 员 ) 也 不 再 那么 肖 天 ， 因 为 版 本 库 人 人 人才 可 更 

改 (当然 是 对 本 地 版 本 库 而 言 ) 。 稍 微 让 贡献 者 感到 困难 的 就 是 如 何 将 自己 对 项 目的 改进 被 

核心 开发 团队 所 了 解 并 接纳 。Git 提 供 了 多 种 途径 ， 一 个 方法 是 先 用 git format-patch 命 令 将 本 
地 提交 转换 为 补丁 文件 或 补丁 文件 序列 ， 再 通过 邮件 发 送 给 核心 开发 团队 。 另 外 一 个 办 法 就 

是 搭建 一 个 自己 专 有 的 共享 版 本 库 ， 通 过 邮件 创建 一 个 拉 搜 请 求 (Pul Request) ， 让 核心 团 
队 的 开发 者 到 自己 的 版 本 库 来 抓 取 (Pull) 。 


GitHub 的 出 现 进一步 推动 了 Git 的 普及 ， 简 化 了 版 本 控制 的 管理 和 操作 流程 ， 为 开发 者 提供 了 
更 好 的 交流 平台 。 如 图 1-4 所 示 。 
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E 1-4 : GitHub 的 协同 模式 


使 用 GitHub， 无 论 是 项 目的 核心 开发 团队 ， 还 是 普通 的 项 目 贡 献 者 都 工作 得 非常 “愉快 ”。 创 建 
项 目 变 得 非常 轻松 ， 创 建 者 只 需 在 GitHub 上 点 击 一 下 鼠标 即 可 创建 一 个 新 版 本 库 ， 通 过 简单 
的 Web 操 作 即 可 完成 项 目 授 权 进 而 组 建 项 目 核心 团队 。 在 GitHub 中 ， 非 核心 团队 成 员 和 参与 项 
目 也 很 容易 。 先 找到 自己 布 望 参与 的 项 目 ， 然 后 只 需 在 Web 上 点 击 一 下 鼠标 即 可 在 自己 的 托 
管 空 间 下 创建 一 个 派生 (fork) 的 项 目 ， 并 对 派生 项 目的 版 本 库 具 有 读 写 的 完全 权限 ， 就 好 像 
这 个 项 目 原本 就 是 由 自己 创立 的 那样 。 当 贡献 者 完成 开发 并 向 自己 派生 的 版 本 库 推送 后 ， 可 
以 通过 GitHub 的 Web 和 界面 向 项 目的 核心 开发 团队 发 送 一 个 Pull Request， 请 求 审核 。 项 目的 核 
心 团队 收 到 Pull Request 后 审核 代码 ， 审 核 通 过 后 可 以 直接 通过 Web 人 界面 执行 合并 操作 接纳 页 
献 者 的 提交 。 


1.2. GitHub 5 X 


是 什么 让 GitHub 如 此 成 功 ?GitHub 有 什么 魔力 ? 


1. 


^ Jt] Git ° 


GitHub 只 支持 Git 格 式 的 版 本 库 托 管 ， 而 不 像 其 他 开源 项 目 托管 平台 还 对 CVS、SVN、Hg 
等 格式 的 版 本 库 进 行 托管 。GitHub 的 哲学 很 简单 ， 既 然 Git 是 最 好 的 版 本 控制 系统 之 一 

(对 于 很 多 喜欢 Git 和 GitHub 的 人 没有 之 一 ) ， 没 有 必要 为 兼顾 其 他 版 本 控制 系统 而 牺牲 
Git 某 些 独 有 特性 。 因 此 没有 支持 其 他 版 本 控制 系统 的 历史 负担 ， 是 GitHub 成 功 的 要 素 之 


— Q 


只 用 Git 并 不 是 说 GitHub 完 全 无 视 其 他 版 本 控制 系统 的 使 用 者 ， 相 反 ，GitHub 面 向 

SVN (Subversion) 用 户 和 Hg (Mercurial) 用 户 开发 了 接口 ， 让 这 些 用 户 可 以 使 用 SVN 
或 Hg 的 客户 端 工具 访问 Git 版 本 库 。 

对 Git 的 完整 支持 。 

相 比 其 他 开源 项 目 托管 平台 ，GitHub 对 Git 版 本 库 提 供 了 完整 的 协议 支持 ， 支 持 HTTP 每 
能 协议 、Git-daemon、SSH 协 议 。 相 比 只 支持 HTTP 协 议 的 GoogleCode，GitHub 通 过 
SSH 协 议 可 以 实现 版 本 库 访 问 的 无 口令 认证 (实际 上 使 用 HTTP 协 议 也 可 以 免 口 令 输入 。 
即 通 过 文件 ~/,netrc 写 入 HTTP 认 证 的 明文 口 邻 。 具体 文件 格式 参见 ftp 命 令 MAN 手 册 中 
相关 介绍 ) 。 


无 处 不 在 的 Git。 


除了 在 版 本 库 托 管 上 使 用 Git，Git 还 被 GitHub 应 用 到 更 多 领域 。 维 基 使 用 Git， 可 以 通过 
克隆 维基 所 在 的 版 本 库 ， 离 线 修改 维基 ; 在 线 粘贴 数据 的 Gist 网 站 [2] 使 用 Git， 记 录 变 更 
历史 ; 以 及 在 Jekyll 应 用 的 帮助 下 ， 用 Git 版 本 库 维护 个 人 网 站 和 博客 等 。 

在 线 编辑 文件 。 

GitHub 提 供 了 在 线 编 辑 文件 的 功能 ， 不 熟悉 Git 的 用 户 也 可 以 直接 通过 浏览 器 修改 版 本 库 
里 的 文件 。 

社交 编程 。 


将 社交 网 络 引 入 项 目 托 管 平台 是 GitHub 的 创举 。 用 户 可 以 关注 项 目 、 关 注 其 他 用 户 进而 

了 解 项 目 和 开发 者 动态 。 项 目的 派生 (Fork) 和 拉 搜 请 求 (Pull Request) 构成 GitHub 最 
独 具 一 格 的 工作 模式 。 对 提交 代码 的 逐 行 评注 及 Pull Request 构 成 了 GitHub 特 色 的 代码 审 
核 。 


商业 上 的 成 功 。 


GitHub 通 过 私有 版 本 库 托管 、 面 向 企业 的 版 本 库 托 管 和 项 目 管理 平台 、 人 员 招 聘 等 付费 
服务 获得 了 商业 上 的 成 功 ， 这 种 成 功 使 得 GitHub 不 必 以 页 面 中 诅 入 广告 的 方式 维持 运 
营 ， 最 大 的 受益 者 还 是 用 户 。 


关注 细节 。 


GitHub Pil 35 X 7] f Ruby on Rails 架 构 ， 在 Web 设 计 中 运用 了 大 量 的 JavaScript、AJAX、 
HTML5 等 技术 ， 支 持 对 使 用 Markdown 等 标记 语言 的 内 容 进 行 泻 染 和 显示 等 。 关 注 细节 使 
得 GitHub 成 为 了 项 目 托管 领域 的 后 起 之 郁 。 
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1.3. 探索 GitHub 


打开 浏览 器 ， 访 问 网 址 https://github.com/， 来 探索 GitHub 吧 。GitHub 的 首页 (图 1-5 所 示 ) 
特意 给 出 了 Git 和 GitHub 的 音标 ， 可 能 不 少 国 人 需要 据 此 校准 一 下 Git 的 读音 (《Git 权 威 指南 》 
第 1 页 就 提 到 了 两 种 常见 的 对 Git 的 读音 错误 。)。 
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Free public repositories, collaborator management, issue tracking, wikis, downloads, code review, graphs and much more.. 


图 1-5 : GitHub 的 首页 
在 首页 的 右上 角 是 导航 条 ， 从 左 至 右 分 别 是 : 注册 和 收费 方案 、 探 索 GitHub、 功 能 、 博 客 和 
登录 。 还 醒目 地 显示 出 不 断 增 长 着 的 注册 用 户 数 和 托管 的 版 本 库 数 目 。 


如 果 想 要 了 解 GitHub 上 哪些 项 目 最 热门 ， 进 而 寻找 到 好 的 开源 产品 ， 那 么 可 以 从 导航 条 中 
的 “Explore GitHub” 开 始 。 图 1-6 显 示 通 过 对 社交 数据 的 分 析 得 到 的 托管 版 本 库 动态 趋势 。 
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El 1-6 : 版 本 库 动 态 趋势 

还 可 以 根据 感 兴 趣 的 人 数 、 建 立 分 支 的 数量 、 关 注 程 度 等 寻找 热门 项 目 。 图 1-7 显 示 分 支 最 多 
的 项 目 是 Homebrew 一 款 用 ruby 开 发 的 苹果 Mac OS X 通 用 的 非 官 方 包 管理 软件 。 考 虑 到 
不 断 攀 升 的 革 果 用 户 数 量 以 及 荔 于 上 手 的 ruby 语 言 ， 这 并 不 奇怪 。 
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图 1-7 : 热门 版 本 库 排 行 


图 1-8 显 示 了 托管 版 本 库 所 用 编程 语言 的 动态 分 布 ， 程 序 员 多 掌握 几 个 热门 编程 语言 一 定 会 对 
找 工 作 有 帮助 。;-) 
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图 1-8 : 托管 项 目的 编程 语言 统计 


GitHub 通 过 屏幕 截图 等 方式 介绍 了 GitHub 的 常见 功能 ， 可 以 通过 点 击 导 航 条 中 的 “Features” 访 
问 到 。 如 图 1-9 可 以 看 到 在 项 目 管理 中 ， 如 何 利 用 GitHub 提 供 的 团队 管理 功能 、 维 基 、 缺 陷 追 
踪 以 及 代码 审核 。 
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El 1-9 : GitHub 功 能 介绍 


博客 也 是 了 解 GitHub 的 一 个 重要 的 途径 ， 可 以 获知 GitHub 的 最 新 动态 ， 如 最 新 改进 等 。 图 1- 
10 显 示 的 是 GitHub 在 感恩 节 推 出 的 促销 活动 : 收费 服务 免费 试用 一 个 月 ! [1] 如果 及 时 关注 博 


客 就 不 会 错过 噢 。 
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(mention autocompletion 
Fl 1-10 : GitHub 博 客 


图 1-10 的 博客 中 一 个 由 小 章鱼 和 小 猫 组 合 而 成 的 吉祥 物 ， 名 字 叫 做 Octocat。 这 个 可 爱 的 
GitHub 吉 祥 物 时 不 时 会 出 来 带 给 你 惊喜 。 


马上 到 GitHub 上 注册 ， 开 始 GitHub 之 旅 。 


2. 加 入 GitHub 


本 章 介绍 如 何在 GitHub 上 注册 账号 ， 并 以 现 有 项 目 为 例 介 绍 GitHub 的 主要 功能 。 
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注册 GitHub 账 号 ， 只 要 点 击 导 航 条 中 的 “Signup and Pricing”， 或 者 点 击 首页 中 那个 大 大 
的 “Plans, Pricing and Signup” 按 钮 ， 即 进入 收费 方案 介绍 及 注册 页 面 。 


收费 ?不 必 担 心 ， 开 源 软件 托管 是 GitHub 的 基石 ， 对 于 开源 项 目的 版 本 库 ( 即 非 私 有 版 本 
E) 的 托管 ，GitHub 是 免费 的 。 在 收费 方案 及 注册 页 面 中 ， 最 上 面 的 就 是 针对 于 开源 的 免费 
托管 方案 ， 如 图 2-1 所 示 。 


g 0 Free for open source 
Unlimited publi: rencsitories and umniimied public collabprasors 





图 2-1 : 针对 开源 项 目 (公开 版 本 库 ) 的 免费 方案 


至 于 本 页 其 他 付费 方案 ， 将 在 后 面 的 章节 介绍 。 点 击 免费 方案 右 侧 的 “Create a free 
account” 按 钮 ， 就 进入 到 注册 页 面 ， 如 图 2-2 所 示 。 


Create your free personal account 


EE Eb vauoo! 37sienals He 


Username 
gotgihut c You're joining tha smarbtest companies in the world 
Email Address 
gotgithub egma eam a Email support 
Upgrade, downgrade or cancel at any time 
Password 


Secure, reliable, always-avallable repository hoating 


Confirm Password 


By clicking an "Create an account" below, you are agreeing to the 
Termas of Service and the Privacy Policy. 





图 2-2 : 账号 注册 
GitHub 的 注册 页 面 非 常 简洁 ， 只 有 登录 ID， 邮 件 地 址 和 口令 需要 输入 。 要 注意 的 是 每 个 邮件 
地 址 只 能 注册 一 次 。 


注册 完毕 即 以 新 注册 的 账号 和 目 动 登录 。 登 录 后 即 进 入 用 户 的 仪表 板 (Dashborad) 页 面 。 首 次 
进入 的 仪表 板 页 面 还 会 在 其 中 显示 GitHub BootCamp (GitHub 新 手 训练 营 ) 的 链接 ， 以 帮助 
新 用 户 快速 入 门 。 如 果 图 2-3 所 示 。 
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图 2-3 : 登录 后 的 GitHub 首 页 


仪表 板 页 面 是 用 户 最 重要 的 页 面 ， 因 为 创建 新 项 目 (新 版 本 库 ) 的 链接 就 位 于 该 页 面 。 重 新 
设计 的 GitHub 用 户 界面 [1] 中 跳 转 到 仪表 板 页 面 的 链接 不 像 之 前 那么 直观 ， 和 鼠标 移动 到 页 面 左 
上 和 角 的 “github” 文 字 图 标 会 发 现 此 图 标 可 以 点 击 ， 该 文字 图 标 即 是 进入 仪表 板 页 面 的 快捷 。 


在 页 面 右上 方 显示 当前 登录 用 户 的 名 称 和 头像 。 图 2-3 中 显示 登录 用 户 为 gotgithub， 而 用 户头 
像 因为 尚未 设置 所 以 显示 为 缺 省 图 上 GitHub 吉 祥 物 Octocat 的 剪影 。 在 页 面 右上 方 还 有 三 
个 图 标 ， 从 左 至 右 分 别 是 : 通知 、 账 号 设置 和 退出 。 点 击 账号 设置 图 标 对 账号 进行 进一步 设 
置 ， 如 图 2-4 所 示 。 
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图 2-4 : 账户 设置 页 


账号 设置 的 第 一 个 页 面 是 对 用 户 公开 身份 信息 进行 设置 ， 所 有 内 容 均 为 可 选项 ， 如 果 卉 写 将 
显示 在 个 人 页 面 中 ， 并 能 被 所 有 人 访问 。 EESAN AAA SHR IRAM RER 

站 : gravatar.com，Gravatar 网 站 提供 的 头像 服务 通用 服务 ， 可 为 大 部 分 Web 应 用 所 使 
用 o 


图 2-4 中 还 显示 了 当前 用 户 使 用 的 GitHub 托 管 方案 〈Free) 和 使 用 统计 。 因 为 当前 注册 用 户 选 
择 的 是 免费 方 委 ， 所 以 可 用 的 私有 版 本 库 数量 和 私有 空间 的 协同 者 数目 都 是 零 。 免 费 方 和 案 拥 

有 300MB 托 管 空间 ， 因 当前 尚未 创建 版 本 库 托 管 ， 所 以 空间 占用 为 零 。GitHub 对 开源 软件 的 
300MB 托 管 空间 限制 并 非 硬 性 限制 ， 可 以 申请 扩 增 托管 空间 ， 如 果 不 存 在 滥用 情况 的 话 。 


点 击 菜单 中 的 “Account Admin”， 可 以 更 改口 令 、 查 看 API Token、 修 改 用 户 名 ， 以 及 删除 自 
身 账 号 ， 如 图 2-5 所 示 。 
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nare token 





Change your username 
Please nola thal you are only given ONE rename. | understand, | want to change my username 
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图 2-5 : 账户 管理 

其 中 API Token 是 和 用 户口 令 相 关 的 密 钥 ， 当 用 户口 令 更 改 时 API Token 也 随 之 更 改 。GitHub 
的 某 些 应 用 会 使 用 API Token 进 行 身份 认证 ， 从 而 避免 直接 使 用 用 户口 仿造 成 泄露 的 风险 。 
API Token 若 泄露 的 危害 要 远 远 小 于 口令 泄露 ， 这 因为 API Token 不 能 用 于 登录 GitHub 网 站 
等 ， 而 且 一 旦 API Token 汇 露 可 以 很 容易 通过 更 改口 令 的 方式 更 换 API Token 。 

点 击 菜 单 中 的 “Email Addresses”， 可 以 添加 和 删除 邮件 地 址 ， 如 图 2-6 所 示 。GitHub 允 许 为 一 
个 账号 绑 定 多 个 邮件 地 址 ， 以 便 能 够 将 Git 版 本 库 中 的 提交 (提交 者 以 “用 户 名 ”的 格式 给 出 ) 
正确 对 应 到 GitHub 账 户 。 


a gotgithub f gmallcom 


Account Admi 
| | Add 


or cancel 
Email Addresses 
oH Public Keys 


lob Profile 


图 2-6 : 邮件 地 址 管理 
GitHub 为 托管 的 Git 版 本 库 提供 SSH 协 议 支 持 ， 即 用 户 可 以 用 公 负 认证 的 方式 连接 到 GitHub 的 
SSH 服 务 器 。 下 面 的 示例 用 ssh 命 令 连接 github.com 的 SSH 服 务 ， 登 录用 户 名 为 git (所 有 
GitHub 用 户 共 享 此 SSH 用 户 名 ， 不 要 写成 其 他 ) o 

$ ssh -T git@github.com 

Permission denied (publickey). 


上 面 的 示例 显示 登录 失败 ， 这 是 因为 我 们 尚未 在 GitHub 账 户 中 正确 设置 公 钥 认证 。 图 2-7 显 示 
的 是 GitHub 的 SSH 公 负 设 置 界面 。 
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图 2-7 : SSHA 4A E 9€ 


要 想 向 GitHub 添 加 SSH 公 钥 ， 首 先 要 确保 正确 生成 了 对 应 的 公 铀 / 私 钥 对 。 关 于 SSH 公 和 乌 认 
证 ， 在 我 的 《Git 权 威 指南 》 一 书 的 “第 29 章 使 用 SSH 协 议 ” 中 有 详细 介绍 ， 这 里 仅 做 简要 的 介 


绍 。 


GitHub 的 SSH 服 务 支持 OpenSSH 格 式 的 公 角 认证， 可 以 通过 Linux、Mac OS X、 或 Cygwin 下 
的 Ssh-keygen 命 令 创建 公 角 / 私 钥 对 。 命 令 如 下 : 


$ ssh-keygen 


然后 根据 提示 在 用 户主 目录 下 的 .ssh 目 录 中 创建 默认 的 公 负 / 私 钥 对 文件 ， 其 

中 -/.ssh/id rsa 是 私 钥 文件 ，-~/.ssh/id_rsa.pub 是 公 铀 文件。 注意 私 钥 文件 要 严 加 保护 ， 
不 能 泄露 给 任何 人 。 如 果 在 执行 ssh-keygen 命 令 时 选择 了 使 用 口令 保护 私 钥 ， 私 钥 文件 是 经 
hR aJ o ETAL -7/.ssh/id rsa.pub 则 可 以 放心 地 公开 给 他 人 。 


也 可 以 用 ssh-keygen 命 令 以 不 同 的 名 称 创建 多 个 公 钥 ， 当 拥有 多 个 GitHub 账 号 时 ， 非 常 重 
要 。 这 是 因为 虽然 一 个 GitHub 账 号 允许 使 用 多 个 不 同 的 SSH 公 铀 ， 但 反 过 来 ， 一 个 SSH 公 刷 
只 能 对 应 于 一 个 GitHub 账 号 。 下 面 的 命令 在 ~/.ssh 目录 下 创建 名 为 gotgithub 的 私 钥 和 名 为 
gotgithub.pub 的 公 负 文件 。 


$ ssh-keygen -C "gotgithubQgmail.com" -f ~/.ssh/gotgithub 


25 Ag 8 ZAR AS AR ER 4E SUR ES (~.ssh/lid_rsa¥ ) 时 ， 使 用 ssh 命 令 连接 远程 主机 时 需要 
使 用 参数 -i 指定 公 角 / 私 钥 对 。 或 者 在 配置 文件 ~/.ssh/config 中 针对 相应 主机 进行 设 吓 。 例 如 对 
于 上 例 创建 了 非 缺 省 公 角 / 私 钥 对 ~/.ssh/gotgithub， 可 以 在 ~/.ssh/config 配 置 文件 中 写 入 如 下 
配置 。 


Host github.com 
User git 
Hostname github.com 
PreferredAuthentications publickey 
IdentityFile -/.ssh/gotgithub 


好 了 ， 有 了 上 面 的 准备 ， 就 将 ~/.ssh/gotgithub.pub 文 件 内 容 找 贝 到 剪 切 板 。 公 钾 是 一 行 长 长 
的 字符 串 ， 若 用 编辑 器 打开 公 铀 文件 会 折 行 显示 ， 注 意 找 贝 时 切 莫 在 其 中 插入 多 余 的 换行 
符 、 空 格 等 ， 否 则 在 公 钥 认证 过 程 因为 服务 器 端 和 客户 端 公 钥 不 匹配 而 导致 认证 失败 。 命 令 
行 下 可 直接 用 pbcopy 命 令 [2] 将 文件 内 容 找 贝 到 筋 切 板 以 避免 捞 贝 错误 : 


$ cat -/.ssh/gotgithub.pub | pbcopy 


Mac 下 的 命令 行 工 具 pbcopy 和 pbpaste 可 以 在 命令 行 下 操作 剪贴 板 ，Linux 下 的 命令 行 工 
具 xsel 亦 可 实现 类 似 功 能 。 在 Linux 下 可 以 创建 别名 用 xsel 命 令 来 模拟 pbcopy 和 pbpaste 
° alias pbcopy-'xsel --input' alias pbpaste-'xsel --output 


然后 将 公 铀 文件 中 的 内 容 粘 贴 到 GitHub 的 SSH 公 铀 管理 的 对 话 框 中 ， 如 图 2-8 所 示 。 
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图 2-8 : 添加 SSH 公 铀 认证 


设置 成 功 后 ， 再 用 Ssh 命令 访问 GitHub， 会 显示 一 条 认证 成 功 信息 并 退出 。 在 认证 成 功 的 信息 
中 还 会 显示 该 公 钥 对 应 的 用 户 名 。 


$ ssh -T gitQgithub.com 
Hi gotgithub! You've successfully authenticated, but GitHub does not provide shell access 


|| pe E 


如 果 您 未 能 看 到 类 似 的 成 功 信 息 ， 可 以 通过 在 Ssh 人 命令 后 面 添加 -v 参 数 加 以 诊断 ， 会 在 兄长 的 
会 话 中 看 到 认证 所 使 用 的 公 钥 文件 等 信息 。 然 后 比 对 所 使 用 的 公 钥 内 容 是 否 和 GitHub 账 号 中 
设置 的 相 一 致 。 

















$ ssh -Tv git@github.com 


debug1: Authentications that can continue: publickey 
debugi1: Next authentication method: publickey 
debugi: Offering RSA public key: /Users/jiangxin/.ssh/gotgithub 


debugi: Entering interactive session. 
Hi gotgithub! You've successfully authenticated, but GitHub does not provide shell access 
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图 2-9 : 求职 信息 管理 


后 一 项 是 向 GitHub 提 供 
已 成 为 一 个 IT 人 才 招 聘 的 途径 ， 如 果 你 需要 找 工 作 的 话 ， 提 供 简 历 并 打开 “Available for 


Professional Bio 


Available for hire 


你 的 求 


R4 & » GitHubTE d — 4-525 FEP Wi ig 


Pared with (GitHub Flavoned Markisen 


的 工作 机 会 。 如 图 2-9 所 示 。 
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2.2. 浏览 托 官 项 目 
在 上 一 节 学 习 了 如 何 建 立 GitHub 的 账户 ， 接 下 来 在 建立 自己 的 项 目 托 管 之 前 ， 先 来 看 看 别人 
是 怎么 做 的 。 
在 GitHub 中 搜索 字符 囊 “GotGit”， 可 以 搜索 到 我 建立 的 一 个 项 目 ， 项 目地 址 
是 : https://github.com/gotgit/gotgit/。 由 上 至 下 ，GotGit 项 目 首页 可 以 分 为 如 下 几 个 区 域 。 
e 区 域 一 : 项 目 概 要 介绍 及 版 本 库 URL 等 。 


项 目 GotGit 托 管 在 组 织 账 号 gotgit 之 下 (项 目 gotgit R- H AP ossxp-com 创建 ， 现 已 转 
移 到 组 织 gotgit 账号 之 下 。)， 并 且 已 经 有 若干 关注 用 户 和 派生 项 目 。 最 下 面 一 行 显示 版 
本 库 的 访问 地 址 ， 只 显示 了 HTTP 和 Git-daemon 两 个 协议 的 URL 地 址 ， 这 是 因为 当前 用 户 
对 该 版 本 库 只 具有 只 读 权 限 ， 因 此 没有 显示 SSH 协 议 的 URL 地 址 。 
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图 2-10 : 版 本 库 概 要 信息 


使 用 任意 一 种 协议 均 可 克隆 该 Git 版 本 库 ， 但 要 注意 只 有 Git 1.6.6 及 以 上 版 本 才 支 持 智能 
HTTP 协 议 ， 低 版 本 Git 则 无 法 用 HTTP 协 议 克 隆 GitHub 上 的 版 本 库 [2] 。 


$ git clone https://github.com/gotgit/gotgit.git 
或 者 使 用 Git -daemon 协 议 。 


$ git clone git://github.com/gotgit/gotgit.git 


e 区 域 二 : 代码 浏览 子 菜单 及 分 支 切换 对 话 框 。 


默认 项 目 代码 页 〈 即 项 目 首页 ) 显示 项 目 文件 列表 〈 即 Files 子 菜单 ) ， 如 图 2-11 所 示 。 
右 侧 还 显示 项 目 gotgit/gotgit 默 认 的 分 支 为 gh-pages 而 非 第 见 的 master 分 支 。 关 于 gh- 
pages 分 支 ， 在 “第 3.5.2 节 创建 项 目 主页 ”会 介绍 该 分 支 的 神奇 用 途 。 


Files Commits Branches 3 Tags i i tument branc? 


12-11 : 代码 浏览 子 菜单 及 分 支 


e 区 域 三 : 显示 最 新 提交 的 提交 说 明 、 提 交 用 户头 像 、 提 交 时 间 等 提交 信息 。 
此 次 提交 对 应 的 提交 |ID。 


ha 有 js Ping i 
remove top p element, which align menu and contents. 
PB ossxp-com 


提交 一 
言 息 


图 2-12 : 


e 区 域 四 : 目录 树 。 每 个 目录 和 文件 后 面 还 显示 最 后 一 次 变更 的 提交 说 明 。 
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Update layout. [cssxp-corm] 
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Move *.thynec into thynec directory. [jiangxin] 
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HEADME.md December O5, 2011 short description for this repo. [ossxp-com] 
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图 2-13 : 目录 树 
e 区 域 五 : 根 目 录 下 的 文件 README.md 格 式 化 为 HTML 输 出 。 
GitHub 内 置 了 多 种 文本 标记 语言 的 支持 ， 如 Markdown、Textile、reStructuredText ` 


asciidoc、Wiki 等 。 当 发 现 根 目 录 下 的 README 文 件 后 ， 会 根据 其 扩展 名 判断 所 用 的 标记 
语言 类 型 ， 自 动 转换 为 HTML 格 式 显 示 。 


README.md 


The errata, screencasting and olhe meenutas lor the book 0o, a book on Git in Chinese. 


The book otti (ISBN B7B-7-111-34967-9] is written by Jiang X and published by China Machine Press al Jun 2011 


图 2-14 : README x fF 


在 GitHub 的 页 面 中 可 以 使 用 键盘 快捷 键 ， 按 下 间 号 (?3) 会 在 弹出 禄 页 面 可 用 的 快 


捷 键 。 
在 项 目的 代码 浏览 页 按 下 字母 “W”"， 弹 出 分 支 切 换 菜单 ， 如 图 2-15 所 示 。 


Got Github 


Files Commits Branches 3 Tags 3 Downloads Cument branch 


Switch Branches/Tags 


master 


图 2-15 : 快捷 键 “W "切换 分 支 


按 下 字母 ， 开 启 目 录 树 中 文件 查找 和 和 过滤。 图 2-16 就 是 在 按 下 字母 后 ， 当 逐一 输入 单 
局“download" 时 的 过 滤 效 果 。 


JE octo: You've acsvated the tio traer y pressing t Surttyping ic lier fe filo list Use T and i innavigase, enter MW vos filas. E 


ama 
download'chot melo 
diwenload'cho1 word 
diwnicadi'ch10/helloworld! main c 
download'chü3 install from git.sh 
dowenload'chtDOmellcwond/ Mak eile 
diwenload'c hey manifest never. ali 
diowenload'ch10/helleworid/. gatignon 
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图 2-16 : 快捷 键 作 开启 过 滤器 在 目录 树 中 搜索 


点 击 代 码 浏览 子 菜单 中 的 “Commits”( 提 交 ) 显示 版 本 库 GotGit 的 提交 历史 ， 如 图 2-17 所 示 。 
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"E otip- aumored December 05, 2011 
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os&xp-com autored December 05, 20171 


Dom sn node = 


TO Add update to the 1st and 2nd print. M) a13729cb8d 


ostap-com authored December 05, 2011 Eeardb anda 


图 2-17 : 提交 历史 


2.2. 浏览 托管 项 目 


提交 历史 页 面 也 支持 快捷 键 ， 按 下 问号 〈?) 或 者 点 击 页 面 中 的 键盘 标志 会 显示 快捷 键 帮助 。 
其 中 快捷 键 了 和 "kk" 用 于 在 提交 列表 中 向 上 和 向 下 选择 提交 ， 在 选中 的 提交 按 下 回 车 键 ， 会 显 
示 该 提交 包含 的 文件 改动 差异 ， 如 图 2-18 所 示 。 


Change font color for stronger text from red to brown. Browse code 
(€ ossxp-com cba157eec 峰村 C6 二 7440/9. 87852 
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图 2-18 : 文本 文件 改动 差异 





EE XCTI 


在 文本 文件 的 差异 比较 中 ， 不 但 将 有 差异 的 行 标识 出 来 ， 还 将 行内 具体 改动 的 字 词 用 特殊 顾 
色 进 行 了 标识 ， 不 由 得 感叹 GitHub 的 细致 入 微 。 


GitHub 还 支持 对 图 形 文件 的 差异 比较 ， 并 提供 四 种 比较 方式 。 在 如 下 地 

址 : http://git.io/image-diff ( 短 格 式 URL， 实 际 对 应 于 : 
https://github.com/cameronmcefee/Image-Diff-View-Modes/commit/8e95f7 4€ £& T — AT 4h] 
提交 。 您 可 以 去 尝试 一 下 不 同 的 图 形 文件 比较 方式 ， 以 便 更 直观 地 观察 图 形 文 件 衣 后 的 改 
动 Y%E6%8F%90%E4%BE%9B%E4%BA9%86%E4%B8%80%E4%B8%AA%E7%A4%BA%E 
4%BE%8B%E6%8F%90%E4%BAY%oA4%FE3%80%82%FE6%82%A8%E5%8F%AF%E4%BB 
%A5%E5%8E%BB%E5%B0%9D%E8%AF%95%E4%B8%80%E4%B8%8B%E4%B8%8D 
%E5%90%8C%E7%9A%84%E5%9B%BE%E5%BD9%A2%E6%96%87%E4%BB%B6%E6 
%AF%949%E8%BE%83%E6%96%B9%E5%BC%8F%EF%BC%8C%E4%BB%A5%E4%BE 
%BF%E69%9B%B4%E7%9B%B4%E8%A7%829%E5%9C9%B0%E8%A7%82%E5%AF%9Fo% 
E5%9B9%BE%E5%BD%A2%E6%96%87%E4%BB%B6%E5%89%8D9%E5%90%8E%E7%9 
A%849%E69%949%B99%E59%8A%A8) ° 


e 默认 修改 前 后 的 两 幅 图 片 堪 右 并 排 显 示 ， 如 图 2-19 所 示 。 
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图 2-19 : 左右 并 排比 较 图 形 文件 差异 


e 选择 交换 显示 比较 修改 前 后 的 图 片 ， 用 鼠标 左右 拖 动 进度 条 ， 可 以 非常 直观 地 看 到 图 片 
的 差异 。 如 图 2-20 所 示 。 
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图 2-20 : 交换 显示 图 形 文 件 比 较 差 弄 
e 还 提供 洋 芝 皮 和 色差 比较 ， 自 己 动手 试 试 吧 。 


网 络 图 是 GitHub 的 一 大 特色 ， 显 示 一 个 项 目的 版 本 库 被 不 同 用 户 派生 (Fork) 后 ， 各 个 版 本 
库 的 派生 关系 。 这 个 网 络 图 最 早 使 用 Flash 实 现 的 ， 目 前 已 经 改 为 HTML5 实 现 [4]。 图 2-21 的 示 
例 网 络 图 来 自 于 Gitosis 项 目 [5]。 
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K 2-21 : Gitosis 项 目 网 络 图 


Pull Requests (4z4&i R) 是 派生 (Fork) 版 本 库 的 开发 者 向 项 目 贡 献 提交 的 方法 。 如 图 2- 
22 所 示 ，GotGit 项 目 目前 没有 未 被 处 理 的 Pull Request， 但 是 可 以 看 到 有 一 个 已 经 关闭 的 Pull 
Request 请 求 。 
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E 2-22 : Pull RequestsZt t 


这 个 Pull Request 是 GitHub 用 户 agate 发 现 了 GotGit 脚 本 中 一 个 和 ruby1.9 不 兼容 的 Bug * 2 
把 agate 派 生 版 本 库 中 的 提交 合并 到 GotGit 版 本 库 后 ， 该 Pull Request 自 动 关闭 。 整 个 Pull 
Request 的 变更 记录 如 图 2-23 所 示 。 
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[09]. PB osaxp-com merged comm? ei95:48 irto EEE fo ECRIRE 0907008 
(€ ossxp-com closed the pull negues June 17, a1 
E 2-23 : Pull Request 的 变更 历史 


缺陷 追踪 (Issue) 也 是 GitHub 工 作 流 中 一 个 重要 的 组 件 。GotGit 项 目 用 缺陷 跟踪 系统 帮助 维 
护 《Git 权 威 指南 》 一 书 的 勘误 ， 图 2-24 可 以 看 到 当前 有 2 个 打开 的 问题 和 9 个 已 关闭 的 问题 。 
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E 2-24 : 缺陷 追踪 


GitHub 还 为 项 目 提供 报表 分 析 。 图 2-25 是 GotGit 项 目 中 用 到 的 开发 语言 分 布 图 。 


2.2. 浏览 托管 项 目 28 
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E 2-25 : GotGit 项 目 开 发 语言 分 布 图 
图 2-26 是 开发 者 对 GotGit 项 目 贡献 分 布 图 。 
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Blocks represent "impact". Impact is (lines added + lines deleted) for all non-merge commits during a week period 


K 2-26 : GotGit 项 目 贡 献 分 布 图 


2.2. 浏览 托管 项 目 


de Uret üA Your Fork 4a» 28 i 


29 


2.3. 社交 网 络 


社交 网 络 的 一 大 特征 就 是 用 户 间 的 相互 关注 ， 从 而 形成 朋友 圈 或 媒体 圈 ， 实 现 便 捷 的 信息 分 
享 和 传播 。GitHub 支 持 项 目 级 别 及 用 户 级 别 的 关注 。 


关注 一 个 项 目 很 简单 ， 只 需 点 击 项 目 名 称 右 侧 的 "Watch" 按 钮 。 





a gotgi / gotgit 
图 2-27 : "A E 8) X i442 


添加 对 项 目的 关注 后 ， 点 击 页 面 左 上 角 的 “github” 文 字 图 标 进 入 仪表 板 (Dashboard) 页 面 ， 
如 图 2-28 所 示 。 
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图 2-28 : 关注 项 目 在 仪表 板 页 的 显示 
仪表 板 页 面 的 左 侧 显示 所 关注 项 目的 最 新 动态 ， 右 侧 会 列表 显示 关注 的 项 目 列表 。 


GitHub 还 可 以 关注 用 户 。 访 问 https://github.com/mojombo 可 以 看 到 mojombo (GitHub 创 始 
者 之 一 ) 的 用 户 页 ， 关 注 他 只 需 点 击 图 2-29 中 的 “Follow” 按 钮 。 从 mojombo 的 用 户 页 还 可 以 看 
到 majombo 关 注 的 开发 者 ， 可 以 以 此 扩大 GitHub 朋 友 圈 。 
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E 2-29 : mojombo£ M P 3 


GitHub 仪 表 板 页 面 ， 有 一 个 “RSS Feed" 链 接 ， 如 图 2-30 所 示 。 点 击 该 链接 可 以 使 用 RSS 客 户 
端 (如 Google Reader) 订阅 ， 实 现 无 需 登 录 GitHub 即 可 访问 所 关注 的 项 目 和 人 的 动态 。 





P sosnnus | Bubacrba 16 your personalized bh Fed Ig earns | 
& 2-30 : RSS Feed 


RSS 中 可 能 包括 隐私 信息 ， 如 私有 版 本 库 的 更 新 信息 ， 那 么 RSS 订 阅 是 如 何 保护 个 人 隐私 
呢 ? 难道 需要 口令 认证 么 ? 查看 一 下 RSS 订 阅 的 URL， 你 会 看 到 类 似 如 下 格式 的 URL 地 址 : 


https://github.com/gotgithub.private.atom?token-z681a8a5a38419ecfb80f8633d4cb4e16 


原来 RSS 订 阅 用 到 了 API Token 进 行 身份 认证 ， 即 保障 了 个 人 RSS 的 私密 性 ， 又 避免 直接 使 用 
明文 口令 导致 的 密码 泄露 。 关 于 API Token ^» 参见 本 章 第 2.1 节 中 相关 介绍 。 


3. 项 目 托管 


本 章 介 绍 如 何在 GitHub 上 创建 一 个 新 项 目 ， 包 括 创 建 版 本 库 及 为 项 目 设计 主页 等 。 


3.1. 创建 新 项 目 


3.1.1. 新 版 本 库 即 大 新 项 目 


Æ GitHub ， 一 个 项 目 对 应 唯一 的 Git 版 本 库 ， 创 建 一 个 新 的 版 本 库 就 是 创建 一 个 新 的 项 目 。 访 
问 仪 表 板 (Dashboard) 页 面 ， 如 图 3-1， 可 以 看 到 关注 的 版 本 库 中 已 经 有 一 个 ， 但 自己 的 版 
本 库 为 零 。 在 显示 为 零 的 版 本 库 列表 面板 中 有 一 个 按钮 “New Repository”， 点 击 该 按钮 开始 创 
建新 版 本 库 。 


Your Repositories (0) 


You don't have any repositories yet! 
Create your first repository or learn more about Git 
and GitHub 


图 3-1 : 版 本 库 列 表面 板 


新 建 版 本 库 的 界面 如 图 3-2 所 示 。 


Create a New Repository 


Project Name — — A Note 
helloworld 
Hf you intend to push a copy ol a repository that ia 

Description (optional) —— — —  —X 


My first GitHub project 









Who has access to this repository? (You can change this later) 


(9 Anyone (learn more about public repos) 





图 3-2 : 创建 新 项 目 


我 们 为 新 建立 的 版 本 库 命名 为 “helloworld”， 相 应 的 项 目 名 亦 为 “helloworld”， 创 建 完毕 后 访问 
项 目 页 ， 提 示 版 本 库 尚 未 初始 化 ， 并 给 出 如 何 初 始 化 版 本 库 的 帮助 ， 如 图 3-3 所 示 。 
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Code Heto i Pul Begueste — ! TEES Waa | Dats & Graphs 


Global setup: 

Sat up gi 

git zar --global user.name "Your Name" 

git config --global user.email gotgithubigmail.com 
Add your public key 


Next steps: 
mkdir helloworld 
ed helloworld 
git init 
keusch README 
git add READHE 
git commit -m first commit 
git remote add origin gitFgithub.comigokgithub/hellaworld.qit 
git push -u origin master 


Existing Git Repo? 
ed existing git repo 
git remote add origin gitigithub.comigotgithub/helloworld.git 
git push -u erigim master 


E 3-3 : 项 目 尚 未 初始 化 


在 图 3-3 中 可 以 看 到 访问 协议 增加 了 一 个 支持 读 写 的 SSH 协 议 ， 访 问 地 址 为 : 
git@github.com:gotgithub/helloworld.git。 注意 任何 GitHub 用 户 均 可 使 用 该 URL 访 问 此 公开 版 
本 库 ， 但 只 有 版 本 库 建 立 者 gotgithub 具 有 读 写 权限 ， 其 他 人 只 有 只 读 权限 。 在 初始 化 版 本 库 
之 人 前， 最 好 先 确 认 是 否 是 用 正确 的 公 角 进行 认证 ， 如 下 ; 


$ ssh -T git@github.com 
Hi gotgithub! You've successfully authenticated, but GitHub does not provide shell access 


a] o E 





3.1.2. 版 本 库 初 始 化 [] 


如 果 是 从 头 创 建 版 本 库 ， 可 以 示 用 先 克 隆 ， 建 立 提 交 数 据 ， 最 后 再 通过 推送 完成 GitHub 版 本 
库 的 初始 化 。 步 骤 如 下 : 


e 克隆 版 本 库 。 


— 


元 隆 过 程 会 显示 警告 ， 不 过 这 个 警告 可 以 忽略 ， 因 为 GitHub 创 建 的 版 本 库 本 来 就 是 一 个 


空白 的 版 本 库 。 


$ git clone gitQgithub.com:gotgithub/helloworld.git 
Cloning into 'helloworld'... 
warning: You appear to have cloned an empty repository. 


e 创建 文件 README.md ( 注 : NUN md > .mkd > .mkdn ° .mdown ° .markdown 4 7j 2& 
尾 的 文件 ， 均 以 Markdown 标 记 语言 语法 进行 解析 并 显示 。) 。 


下 面 是 一 段 示 例文 字 ， 把 这 段 文字 保存 为 文件 README.md， 该 文件 的 内 容 将 会 直接 显 
示 在 项 目 首页 中 (显示 效果 参见 后 面 的 图 3-5) 。 


# 我 的 第 一 个 GitHub 项 目 


这 是 项 目 [helloworld](https://github.com/gotgithub/helloworld) ， 
欢迎 访问 。 


这 个 项 目的 版 本 库 是 **Git 格 式 ** ， 在 Windows、Linux、Mac OS X 
平台 都 有 客户 端 工具 可 以 访问 。 虽 然 版 本 库 只 提供 Git 一 种 格式 ， 

但 是 你 还 是 可 以 用 其 他 用 其 他 工具 访问 ，; 如 ``svn`` 和 ``hg`>\ e 

HH 版 本 库 地 址 

支持 三 种 访问 协议 : 

* HTTP: ^https://github.com/gotgithub/helloworld.git' œ 
* Git: '"git://github.com/gotgithub/helloworld.git' œ 

* SSH: "ssh://gitügithub.com/gotgithub/helloworld.git'^ œ 
BH 克隆 版 本 库 

操作 示例 : 


$ git clone git://github.com/gotgithub/helloworld.git 


上 面 这 上 段 文字 采用 Markdown 格 式 ， 您 也 可 以 使 用 其 他 支持 的 格式 ， 只 要 确保 README 文 件 使 
用 正确 的 扩展 名 。 本 书 附录 部 分 介绍 了 Markdown 及 其 他 GitHub 支 持 的 标记 语言 。 关 于 
Markdown， 目 前 我 们 只 需 知 道 这 一 个 易于 识别 和 理解 的 纯 文本 格式 ， 可 以 方便 的 转换 为 
HTML 。Markdown 语 法 非常 像 我 们 在 写 邮 件 (ALA) 时 用 空 行 来 分 隔 段 落 、 用 星 号 开启 列 
表 、 用 缩 进 表示 引用 内 容 等 等 。 


e 添加 README.md 文 件 并 提交 。 


$ git add README.md 
$ git commit -m "README for this project." 


e 向 GitHub 推 送 ， 完 成 版 本 库 初 始 化 。 


$ git push origin master 


后 查看 GitHub 上 新 建 项 E 的 首页 o 项 E 首页 的 上 半 部 2cp EXE 纪念 了 一 个 新 的 提交 , 
以 及 版 本 库 目 录 树 中 包含 的 文件 ， 如 图 3-4 所 示 。 


* gotgithub / helloworld 4FAdmim — C Umwatch — (1 Fork — al) PullRequest Œi 1 


Code Network Pull Requests c issues O Wiki € 51818 & Graphs 


È Clone in Mac EJ EP ESM HTTP  Gitfsed-Only git&githut n:gotgithub/helloworld.git D, PReedeWrita moos: 


A^ master = 


Files Comrmnils Branches 1 
o mater 
README flor this project 
"B osssp-com 32deedb12 
helloworld / 
hestony 
RE ADME md 2 minutes ago README for this project. [cesxp-com] 


图 3-4 : 完成 推送 后 的 项 目 首页 上 半 部 分 

在 项 目 首页 的 下 半 部 分 ， 会 看 到 README.md 文 件 被 转换 为 HTML 显 示 ， 如 图 3-5 所 示 。 
README.md 
我 的 第 一 个 GitHub 项 目 


这 是 项 目 heloword, Xm. 


这 十 项 目的 属 本 亩 是 Gul . E Windows. Linux. Mac OS X £l E PIAudg. Sf RSIRGITMAEX. 企 是 你 还 是 可 以 刷 其 他 用 
其 居 工具 访问 ,各 ma 和 bg 。 


版 本 库 地 址 
EEE 


è HTTPHHX: httpair//githun.com/gotgithub/belloworld.git s 
è Ga: giti//gitbub.com/gotgithub/helloworld.git ə 


* SEHH: sahn://gitigithub.com/gotgithub/helloworld.gi 
克隆 版 本 库 


$ git clone git://github.com/gotgithub/helleoeworzld.git 
图 3-5 : 完成 推送 后 的 项 目 首页 下 半 部 分 


3.1.3. 从 已 有 版 本 库 创建 
如 果 在 GitHub 项 目 初始 化 之 前 ， 数 据 已 经 存在 于 本 地 版 本 库 中 ， 显 然 像 上 面 那 样 先 克 隆 、 再 
提交 、 后 推送 的 方法 就 不 适宜 了 。 应 该 采用 下 面 的 方法 。 


为 试验 新 的 版 本 库 初 始 化 方法 ， 先 把 刚刚 新 建 的 测试 项 目 “helloworld" 删 除 ， 同 时 也 将 本 地 工 
作 区 中 克隆 的 “helloworld" 删 除 。 警 告 : 删除 项 目的 操作 非常 危险 ， 不 可 恢复 ， 懂 用 。 


e 点 击 项 目 首 页 中 项 目 名 称 汐 边 的 “Admin" 按 钮 进入 项 目 管理 页 ， 再 点 击 页面 最 下 方 的 删除 
版 本 按钮 ， 如 图 3-6 所 示 。 





Transfer Ownership 
You don't have admin rights in any organizations. 
To transfer this repo to another user, please contact support. 


Delete this repository 
Once you delete a repository, there is no going back. Please be certain. 


Delete this repository 





图 3-6 : 删除 项 目 
e 然后 再 重建 版 本 库 中 elloworld”， 如 本 章 一 开始 图 3-2 所 示 。 
接 下 来 使 用 下 面 的 步骤 完成 “helloworld" 版 本 库 的 初始 化 。 


e 本 地 建立 一 个 Git 版 本 库 。 


mkdir helloworld 
cd helloworld 
git init 


€ 06 A 


e 然后 在 版 本 库 中 添加 示例 文件 ， 如 README.md 文 件 ， 内 容 同 前 。 


$ git add README .md 
$ git commit -m "README for this project." 


e 为 版 本 库 添加 名 为 origin 的 远程 版 本 库 。 


$ git remote add origin gitQgithub.com:gotgithub/helloworld.git 


e 执行 推送 命令 ， 完 成 GitHub 版 本 库 的 初始 化 。 注 意 命令 行 中 的 -U 参 数 ， 在 推送 成 功 后 自 
动 建立 本 地 分 支 与 远程 版 本 库 分 支 的 追踪 。 


$ git push -u origin master 


TAE DR. E 


3.2.1. 强制 推送 


细心 的 读者 可 能 从 图 3-4 已 经 看 出 ， 显 示 的 提交 者 并 非 gotgithub 用 户 ， 而 是 一 个 名 为 0ssxp- 
com 的 用 户 ， 这 是 因为 GitHub 是 通过 提交 中 的 邮件 地 址 来 对 应 到 GitHub 用 户 的 。 看 看 提交 说 
明 : 


$ git log --pretty-fuller 
commit 92dee9b8125afc9a606394ed463f9f264f2d3d58 


Author: Jiang Xin 
AuthorDate: Wed Dec 14 14:52:40 2011 +0800 
Commit : Jiang Xin 


CommitDate: Wed Dec 14 14:52:40 2011 +0800 


README for this project. 


原来 提交 用 户 设置 的 邮件 地 址 并 非 gotgithub 用 户 设 置 的 邮件 地 址 。 补 救 办 法 就 是 对 此 提交 进 
行 修改 ， 然 后 强制 推送 到 GitHub。 


E 


e 重新 设置 User.name 和 User.email 配 置 变 量 。 


因为 gotgithub 是 一 个 仅 在 本 书 使 用 的 示例 账号 ， 我 可 不 想 影 响 本 地 其 他 项 目的 提交 
此 下 面 的 设置 命令 没有 使 用 --global 参 数 ， 只 对 本 地 helloworld 版 本 库 进行 设置 。 


$ git config user.name "Jiang Xin" 
$ git config user.email "gotgithubQgmail.com" 


e 执行 Git 修 补 提交 命令 。 


注意 使 用 参数 --reset-author 会 将 提交 信息 中 的 属性 Author 连 同 AuthorDate 一 并 修改 ， 砂 
则 只 修改 Commit 和 CommitDate。 参 数 -C HEAD 维 持 提交 说 明 不 变 。 


$ git commit --amend --reset-author -C HEAD 


e 查看 提交 日 志 ， 发 现 提 交 者 信息 和 作者 信息 都 已 经 更 改 。 


$ git log --pretty-fuller 
commit e1e52d99fa71fd6f606903efa9da04fd0055fca9 


Author: Jiang Xin 
AuthorDate: Wed Dec 14 15:05:47 2011 +0800 
Commit : Jiang Xin 


CommitDate: Wed Dec 14 15:05:47 2011 +0800 


README for this project. 


e 直接 推送 会 报错 。 


错误 信息 中 出 现 non-fast-forword M ext Np ， 含义 为 要 推送 的 提交 并 非 继 远程 版 
本 库 最 新 提交 之 后 的 提交 ， 推 送 会 造成 禾 盖 导致 服务 器 端 有 数据 (提交 ) 会 丢失 。 
$ git push 
To git@github.com:gotgithub/helloworld.git 
! [rejected] master -> master (non-fast-forward) 


error: failed to push some refs to 'gitQgithub.com:gotgithub/helloworld.git' 
To prevent you from losing history, non-fast-forward updates were rejected 
Merge the remote changes (e.g. 'git pull') before pushing again. See the 
'Note about fast-forwards' section of 'git push --help' for details. 


e 使 用 强制 推送 。 


对 于 此 例 ， 考 虑 到 还 没有 其 他 人 关注 helloworld 这 个 刚刚 建立 的 示例 项 目 ， 显 然 不 需要 向 
上 面 命令 的 错误 信息 所 提示 的 那样 先 执行 git pull 合 并 上 游 版 本 库 再 推送 ， 而 是 选择 强制 推 
送 ， 以 新 的 修补 提交 覆盖 包含 错误 提交 者 |D 的 提交 。 


$ git push -f 
Counting objects: 3, done. 
Delta compression using up to 2 threads. 
Compressing objects: 100% (2/2), done. 
Writing objects: 100% (3/3), 629 bytes, done. 
Total 3 (delta 0), reused © (delta 0) 
To git@github.com:gotgithub/helloworld.git 
+ 92dee9b...ei1e52d9 master -> master (forced update) 


完成 强制 推送 后 ， 再 查看 GitHub 项 目 页 面 ， 会 发 现 提 交 者 已 经 显示 为 gotgithub 用 户 。 如 图 3-7 
所 示 。 
Files ^ cmrmiáte Branches i A masir ~ 
README for this project 
ry gotgitnuh 12t52dB8Fa 


图 3-7 : 强制 更 新 后 ， 提 交 者 已 更 改 


3.2.2. 新 建 分 支 
Git 的 分 支 就 是 保存 在 .git/refs/heads/ “f 命名 空间 下 的 引用 。 引 用 文件 的 内 容 是 该 分 支 对 应 的 ] 


提交 |D。 当 前 版 本 库 中 的 默认 分 支 master 就 对 应 于 文件 ,git/refs/heads/master ° 


— 2 建 分 支 ， 首 先 要 在 本 地 版 本 库 中 创建 新 的 分 支 ( 即 引 用 ) ， 然 后 用 推 
命令 将 本 地 创建 的 新 的 引用 连同 所 指向 的 提交 推送 到 GitHub 版 本 库 中 完成 GitHub 上 分 支 的 
^ "id ° 操作 如 下 


e 本 地 版 本 库 中 建立 新 分 支 mybranch1。 


创建 分 支 有 多 种 方法 ， 如 使 用 git branch 命 令 ， 但 最 为 便捷 的 就 是 git checkout-b 命 令 ， 同 


时 完成 新 分 支 的 创建 和 分 支 切换 。 


$ git checkout -b mybranch1 
Switched to a new branch 'mybranchi' 


—— 


e 为 了 易于 识别 ， 添 加 一 个 新 文件 hello1， 并 提交 


$ touch hello1 


$ git add hello1 

$ git commit -m "add hello1 for mark." 

[mybranchi f46a284] add hello1 for mark. 
© files changed, © insertions(+), © deletions(-) 
create mode 100644 hello1 


e 通过 推送 命令 ， 将 本 地 分 支 mybranch1 推 送 到 GitHub 远 程 版 本 库 ， 完 成 在 GitHub 上 的 新 
分 支 创建 。 


$ git push -u origin mybranch1 
Counting objects: 4, done. 
Delta compression using up to 2 threads. 
Compressing objects: 100% (2/2), done. 
Writing objects: 100% (3/3), 281 bytes, done. 
Total 3 (delta 0), reused © (delta 0) 
To gitQgithub.com:gotgithub/helloworld.git 
* [new branch] mybranchi -> mybranchi 
Branch mybranchi set up to track remote branch mybranchi from origin. 


在 GitHub 上 查看 版 本 库 ， 会 看 到 新 增 了 一 个 分 支 mybranch1， 不 过 默认 分 支 仍 为 master， 如 


图 3-8 所 示 。 


Files Commit: Branche: 
Switch Branches/Tags 


mate: 
README for this project 


m getgahub 


helloworld / 


README tör this proiecit. [pssxp-co 


README. md 22 minutes ago 


图 3-8 : 版 本 库 新 增 了 一 个 分 支 


3.2.3. 设置 默认 分 支 
包含 多 个 分 支 的 话 。 例 如 修改 版 本 库 


可 以 改变 GitHub 上 版 本 库 显 示 的 默认 分 支 ， 如 果 版 本 库 包含 
的 默认 分 支 为 mybranch1， 点 击 项目 名 称 汐 边 的 “Admin 按钮 ， 修 改 项 目的 默认 分 支 。 如 图 3-9 


所 示 。 


x gotgitub | helloworld 4 Backis Goume — € i i 


helloworkd = Repasitory Administratian 


Options Settings 


Repository Name 


Rename 


Vialtility (a) Public x Prwate `} 


Deiault Branch J mage 
myibranch 


图 3-9 : 设置 缺 省 分支 


设置 了 GitHub 默 认 分 支 后 ， 如 果 再 从 GitHub 克 隆 版 本 库 ， 本 地 克隆 后 版 本 库 的 默认 分 支 也 将 
px UB o 


$ git clone gitQgithub.com:gotgithub/helloworld.git helloworld-nb 
Cloning into 'helloworld-nb'... 

remote: Counting objects: 6, done. 

remote: Compressing objects: 1009; (4/4), done. 

remote: Total 6 (delta 0), reused 6 (delta 0) 

Receiving objects: 100% (6/6), done. 

$ cd helloworld-nb 

$ git branch 

* mybranch1 


实际 上 修改 GitHub 上 版 本 库 的 默认 分 支 ， 就 是 将 GitHub 版 本 库 的 头 指 针 HEAD 指 向 了 其 他 分 
支 ， 如 mybranch1 分 支 。 这 可 以 从 下 面 命令 看 出 。 


$ git branch -r 
origin/HEAD -> origin/mybranchi 
origin/master 
origin/mybranchi 


也 可 以 从 git Is-remote 4? 4 & d: 3:48 4 HEAD» 2] M refs/heads/mybranch148 19 IF] — Aat $e 84 
哈 希 值 ? 


$ git ls-remote 
From gitQgithub.com:gotgithub/helloworld.git 


f46a28484adb6cib4830eb4df582325c740e9d6c HEAD 
e1e52d99fa71fdef606903efa9daOAfdOO055fca9 refs/heads/master 
f46a28484adb6cib4830eb4df582325c740e9d6c refs/heads/mybranch1 


$ git branch -d mybranch1 
error: Cannot delete the branch 'mybranchi' which you are currently on. 


错误 信息 显示 不 能 删除 当前 工作 分 支 。 因 此 先 切换 到 其 他 分 支 ， 例 如 从 GitHub 版 本 库 中 取出 
master 分 支 并 切换 。 


$ git checkout master 


可 以 看 出 新 的 工作 分 支 为 master 分 支 。 


$ git branch 
* master 
mybranchi 


现在 可 以 删除 mybanch1 分 支 。 下 面 的 命令 之 所 以 使 用 -D 参 数 ， 而 非 -d 参 数 ， 是 因为 Git 在 删除 
分 支 时 为 避免 数据 丢失 ， 默 认 焚 止 删除 尚未 合并 的 分 支 。 参 数 -D 则 可 强制 删除 尚未 合并 的 分 
支 o 


$ git branch -D mybranch1 
Deleted branch mybranchi (was f46a284 ) . 


现在 只 是 本 地 分 支 被 删除 了 ， 远 程 GitHub 服 务 器 上 的 mybranch1 分 支 尚 在 。 删 除 远 程 GitHub 
版 本 库 中 的 分 支 就 不 和 din branch 命 令 ， 而 是 要 使 用 git push 命 令 ， 不 过 在 使 用 推送 分 支 命 
令 时 要 使 用 一 个 特殊 的 引用 表达 式 (冒号 前 为 空 ) 。 如 下 : 


$ git push origin :mybranchi 
remote: error: refusing to delete the current branch: refs/heads/mybranch1 
To gitQgithub.com:gotgithub/helloworld.git 

! [remote rejected] mybranchi (deletion of the current branch prohibited) 
error: failed to push some refs to 'gitQgithub.com:gotgithub/helloworld.git' 


为 什么 删除 远程 分 支出 错 了 呢 ? 是 因为 没有 使 用 强制 推送 么 ? 


实际 上 即使 使 用 强制 推送 也 会 遇 到 上 面 的 错误 。GitHub 发 现 要 删除 的 mybranch1 分 支 是 远程 
版 本 库 的 缺 省 分 支 ， 因 而 禁止 删除 。 重 新 访问 GitHub 的 项 目 管理 页 面 ， 将 缺 省 分 支 设置 回 
master 分 支 ， 参 照 图 3-9。 然 后 再 次 执行 如 下 命令 ， 即 可 成 功 删除 分 支 。 

$ git push origin :mybranch1 


To gitQgithub.com:gotgithub/helloworld.git 
- [deleted] mybranch1 


执行 git ls-remote 命 令 可 以 看 到 GitHub 远 程 版 本 库 已 经 不 存在 分 支 mybranch1。 


$ git ls-remote git@github.com:gotgithub/helloworld.git 

From git@github.com:gotgithub/helloworld.git 
e1e52d99fa71fd6f606903efa9da04fd0055fca9 HEAD 
e1e52d99fa71fd6f606903efa9da04fd0055fca9 refs/heads/master 


3.2.5. € 4 3 


里 程 碑 即 tag， 其 管理 和 分 支管 理 非常 类 似 。 里 程 碑 和 分 支 一 样 也 是 以 引用 的 形式 存在 的 ， 保 
存在 .git/refs/tags/ 路 径 下 。 引 用 可 能 指向 一 个 提交 ， 但 也 可 能 是 其 他 类 型 (Tag 对 象 ) 。 


e 轻 量 级 里 程 碑 : 用 git tag [] 命令 创建 ， 引 用 直接 指向 一 个 提交 对 象 。 

e 带 说 明 的 里 程 碑 : 用 git tag -a [] 命令 创建 ， 并 且 在 创建 时 需要 提供 创建 里 程 碑 的 说 明 。 
Git 会 创建 一 个 tag 对 象 保存 里 程 碑 说 明 、 里 程 碑 的 指向 、 创 建 里 程 碑 的 用 户 等 信息 ， 里 程 
碑 引 用 指向 该 Tag 对 象 。 

e 带 签名 的 里 程 碑 : 用 git tag -s [] 命令 创建 。 是 在 带 说 明 的 里 程 碑 的 基础 上 引入 了 PGP 签 
名 ， 保 证 了 所 创建 的 里 程 碑 的 完整 性 和 不 可 拒绝 性 。 


下 面 演 示 一 下 里 程 碑 的 创建 和 管理 。 


e 先 在 本 地 创建 一 个 新 提交 。 


touch hello1 
git add hello1 
git commit -m "add hello1 for mark." 


€) 0 096 


e 本 地 创建 里 程 碑 mytag1、mytag2 和 mytag3。 


$ git tag -m "Tag on initial commit" mytagi HEAD^ 
$ git tag -m "Tag on new commit" mytag2 
$ git tag mytag3 


e 查看 新 建立 的 里 程 碑 。 


$ git tag -l -n1 


mytagi Tag on initial commit 
mytag2 Tag on new commit 
mytag3 add helloi for mark. 


e 将 本 地 里 程 碑 推送 到 GitHub 远 程 版 本 库 。 


$ git push origin refs/tags/* 

Counting objects: 6, done. 

Delta compression using up to 2 threads. 
Compressing objects: 100% (4/4), done. 
Writing objects: 100% (5/5), 548 bytes, done. 
Total 5 (delta 0), reused © (delta 0) 

To gitQgithub.com:gotgithub/helloworld.git 


* [new tag] mytag1 -> mytagi 
* [new tag] mytag2 -> mytag2 
* [new tag] mytag3 -> mytag3 


e 删除 本 地 里 程 碑 。 


$ git tag -d mytag3 
Deleted tag 'mytag3' (was c71231c) 


e 删除 GitHub 远 程 版 本 库 中 的 里 程 碑 。 


$ git push origin :mytag3 
To gitQgithub.com:gotgithub/helloworld.git 
[deleted] mytag3 


此 时 查看 GitHub 上 的 项 目 页 ， 会 看 到 已 有 两 个 里 程 碑 ， 如 图 3-10 所 示 。 


Files Comrmits Branches i 











mater Switch Branches/Tags 
README or this project. 
f onem 
Breaches Tags 
helloworld / 
README. md about an hour ago README for this project. [assxp-com] 


图 3-10 : 里 程 碑 列表 





3.3. 公 铀 认证 管理 


开发 者 向 GitHub 版 本 库 写 入 最 常用 到 的 协议 是 SSH 协 议 ， 因 为 SSH 协 议 使 用 公 角 认证 ， 可 以 
实现 无 口令 访问 ， 而 若 使 用 HTTPS 协 议 每 次 身份 认证 时 都 需要 提供 口令 (可 以 通过 在 文 

fF -/.netrc 中 写 入 明文 口令 实现 使 用 HTTPS 协议 时 也 能 自动 完成 认证 。 具 体格 式 参 见 ftp 命 
令 的 MAN 手 册 中 相关 介绍 )。 使 用 SSH 公 铀 认证 ， 就 涉及 到 公 钥 的 管理 。 


3.3.1. A P AAA E 


开发 者 可 能 会 从 不 止 一 台电 脑 访 问 GitHub 中 的 版 本 库 〈 用 SSH 协 议 ) ， 因 不 同 的 电脑 有 不 同 
的 公 钥 / 私 钥 对 ， 这 就 需要 为 GitHub 账 号 添加 多 个 公 钥 。 点 击 账号 设置 中 的 “SSH Public 
Keys”" 进 入 SSH 公 铀 管理 界面 ， 如 图 3-11 所 示 。 

Public Profile My Mac OS X (edit) 


Account Admin 


Title 
Email Addresses Key on Windows 
SSH Public Keys Key 


s5h-rsa 

AAAAB3NzoClyc2EAAAADAQABAAABAODpzAzFylgkO0DAF qulc3QrFBib 
pZS08IxFIriGHVRd21241716/daB89qoWaSu]/AuChEdGmexdpz /1« 79 
üz7580jm71?9g1ZeVrÜrGWxZRFX1QDAHYBaceVdGwbSuubDKdtVH/qhb? 
S2H1XDs«eaZGmJR22RupaFErGHatHXxwhyxZFMpOcVet4ág9npf /1zM« 


Job Profile 


FnQFdJldadV2yCbJx jBTInFMSAEDAKZNZYOHk1npHtP/(QL teNBHBXd 
GUJf6vEmiS« sVDyOG6uAZMGNOSmYMSL ekAQTSariz35wbgS5ZkgaTW3aV 
JOmBRODdJA f ynHBV6ugZa2qBBScm3xccANTWKDsSStH 

gotgithub&wi ndows| 


"acd roy DEA 





Our ASA fingerprint is 16:2 7:ac:a5:76:28-2d:36:53:15:56:4d ebd lab :4 B8 


图 3-11 : SSH 2 44 e 3€ 


如 图 3-11， 在 创建 gotgithub 账 号 一 开始 ， 就 手工 添加 了 名 为 "My Mac OS X” 的 公 钥 ， 显 然 这 是 
为 苹果 电脑 准备 的 。 图 中 正在 添加 的 名 为 “Key on Windows” 是 为 Windows 环 境 下 使 用 SSH 协 
议 访 问 GitHub 准 备 的 公 和 钥 。 


当 添 加 了 新 的 公 角 后， 无 论 是 从 哪 台电 脑 (苹果 或 PC) 用 SSH 协 议 访 问 版 本 库 时 都 拥有 相同 
授权 ， 即 都 是 以 gotgithub 账 号 身份 来 访问 。 例 如 用 户 级 公 钥 访问 GitHub 的 SSH 服 务 ， 在 提示 
信息 中 会 显示 用 户 ID， 如 下 : 


$ ssh -T gitQgithub.com 
Hi gotgithub! You've successfully authenticated, but GitHub does not provide shell access 


Aoo: O 


3.3.2. E AAE 


多 增加 一 个 用 户 级 别 的 公 钥 ， 就 意味 着 可 以 从 另外 一 台电 脑 访 问 该 用 户 所 有 版 本 库 。 但 有 时 
只 硕 望 从 某 台 电脑 上 向 某 一 个 版 本 库 * 写 入 ”， 其 他 版 本 库 则 不 可 写 ， 这 可 以 通过 设置 版 本 库 级 
别 的 公 钥 认证 实现 。 


以 项 目 管理 者 (创建 者 ) 身份 登录 GitHub， 例 如 以 gotgithub 用 户 身 份 访问 


gotgithub/helloworld 版 本 库 ， 进 入 到 项 目的 管理 页 面 ， 选 择 菜 单 中 的 “Deploy Keys”， 即 可 设 
置 项 目 级 别 公 钥 。 如 图 3-12 所 示 。 


* gotgithub / helloworld t Bach ba Source ii d i 


halloworid = Rapasitary Administration 


Duel Enpus give ar Aer A t] 
Fun " x [] |] i 了 
LATTE s 
' PL ilis Vy R 一 IR 


Gf urs. U you want à kiy ID enable 
Collaborators lar client! Jie — el 


Sarvica Hooks 


zzh-rsü 
AAAABiHraollyc2EARAADACQARAAARADOPaSLIX 34 TY UL nz HS EL mud 
wTKrD?7eD2 Jdia«gbHFTELrx47dagl FHAN phi Va x2DalWZsEeTanX 


Deploy Keys 
avv rFOÜSORNINS x WeSDdDsH4MViesYLFjPHTaRPw2dFyLFklzS14TY 33 
EAolluGL1xxTOs JdÜX«N3o2DOMi BVIDEKB 1C "a3 UM"TMEzK LO 8 2M. 
M?grFirbBHafroLAas2MITrÀ LHPOLGE [ «DewbBrz 3KvvDry 0nd 7yL RIAHNSN 
EDak dii baPanPESS5ihtlTHLENEaIPYyRPYZTF sg jat tiot HeukaD 
Stof BzRidGB7EusyOhlAbRIvImoldaickASCcB/EX/ ax client 





A 3-12 : 项 目 级 公 角 管理 

就 像 一 个 用 户 可 以 设置 多 个 用 户 级 公 角 一样 ， 也 可 以 为 一 个 项 目 设 置 多 个 项 目 级 公 和 钥 。 无 论 
是 项 目 级 公 钥 还 是 用 户 级 公 钥 都 有 同样 的 限制 : 一 个 公 角 只 能 使 用 一 次 。 

当 使 用 项 目 级 公 铀 访问 GitHub 的 SSH 服 务 ， 会 在 提示 信息 中 显示 版 本 库 ID 而 非 用 户 ID。 如 下 
的 命令 输出 中 显示 了 版 本 库 IDgotgithub/helloworld 。 


$ ssh -i -/.ssh/deploy-key -T gitQgithub.com 
Hi gotgithub/helloworld! You've successfully authenticated, but GitHub does not provide s 


Hug LLL x rl 





3.4. 版 本 库 钓 子 扩展 


通过 钧 子 扩 展 ，GitHub 托 管 的 版 本 库 可 以 和 外 部 应 用 实现 整合 。 整 合 的 接口 完全 开放 ， 开 发 

者 可 以 访问 GitHub 的 开源 项 目 github/github-services 开发 新 的 应 用 整合 脚本 。 目 前 GitHub 已 
经 支持 超过 50 个 外 部 应 用 的 整合 ， 在 这 里 恕 不 一 一 列举 ， 仅 以 helloworld 项 目 为 例 ， 介 绍 几 个 
常见 应 用 的 整合 。 


3.4.1. 邮件 通知 功能 


置 邮 件 通知 ， 可 以 实现 新 提交 推送 至 版 本 库 时 ， 发 送 通知 邮件 。 在 版 本 库 的 管理 界面 ， 
PIA Hooks” 中 的 Email 进入 邮件 通知 配置 界面 ， 如 图 3-15 所 示 。 配 置 界面 很 简单 ， 
邮件 地 址 ， 选 择 激活 即 可 。 为 了 便于 整个 团队 都 和 ST ， 可 以 将 收 件 地 址 设置 为 一 
个 邮件 列表 。 如 果 选 择 “Send From Author”， 邮 件 的 发 件 者 显示 为 提交 者 的 邮件 地 址 ， 否 则 发 
件 者 为 noreply@github.com 。 


@ gotgitnub / helloworld * BacktoSoume — 41 41 
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图 3-15 : 邮件 通知 功能 配置 


邮件 通知 配置 生效 后 ， 当 有 新 提交 推送 到 版 本 库 时 ， 会 发 出 通知 邮件 ， 如 图 3-16 所 示 。 


Got Github 


a SotGitHub 








| f172c5: README for this project. 





1 个 帖子 - RESP - SENARREN, Ex AE) - aA SE 
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Branch: refs/headsimaster 
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Auto e um YE: n COT» 
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Changed paths: 

A README. mkg 
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README tor this project. 
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prier cis paths: 
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Compare; hilpa Ma 


mu BEHËN HE RERAN 


图 3-16 : 提交 触发 邮件 通知 


3.4.2. fcRedmine € & 


Redmine 是 一 个 开源 的 项 目 管理 平台 ， 用 于 项 目的 需求 管理 和 缺陷 跟踪 。Redmine 可 以 和 多 
种 版 本 库 (包括 Git) 整合 ， 可 以 直接 通过 Web 界 面 浏览 Git 提 交 ， 还 实现 了 提交 和 问题 的 关 


Redmine 需 要 周期 性 地 扫描 版 本 库 ， 以 便 更 新 内 置 数据 库 及 建立 提交 和 问题 的 关联 。 通 第 是 
以 计划 任务 (crontab) 的 方式 实现 版 本 库 的 周期 性 扫描 ， 这 导致 Redmine 中 版 本 库 更 新 会 存 


在 一 定 的 延迟 。GitHub 提 供 的 Redmine 整 合 的 钧 子 脚本 能 够 在 GitHub 版 本 库 更 新 后 ， 通 过 
WebService 触 发 Redmine 主 动 打 描 Git 版 本 库 获 取 更 新 。 


GitHub 提 供 的 Redmine 整 合 的 配置 界面 如 图 3-17 所 示 。 


3.4. 版 本 库 钧 子 扩 展 
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E 3-17 : 5SRedmine € 


图 3-17 中 的 地 址 是 Redmine 部 署 的 URL 地 址 ， 项 目 ID 是 Redmine 中 的 相关 项 目 ( de J& 2.5 
则 更 新 所 有 项 目 ) ， 而 “Api Key" 并 非 GitHub 项 目 中 配置 的 Api Key， 而 是 Redmine 中 为 版 本 库 
更 新 配置 的 全 局 Api Key。 相 应 的 Redmine 配 置 界 面 如 图 3-18 所 示 。 


配置 
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E 3-18 : Redmine 中 的 API Key & E 


3.5. 建立 主页 


很 多 开源 项 目 托管 平台 都 支持 为 托管 的 项 目 建立 主页 ， 但 主页 的 维护 方式 都 没有 GitHub 这 人 么 
酮 。 大 多 数 托 管 T S8 iniri d 或 类 似 服 务 ， 用 户 把 制作 好 的 网 页 或 脚本 上 传 了 事 ， 
而 在 GitHub 用 户 通过 创建 特殊 名 称 的 Git 版 本 库 或 在 Git 库 中 建立 特别 的 分 支 实 现 对 主页 的 维 
护 。 


3.5.1. 创建 个 人 主页 


— 为 每 一 个 用 户 分 配 了 一 个 二 级 域名 .github.io， 用 户 为 自己 的 二 级 域名 创建 主页 很 容 
， 只 要 在 托管 空间 下 创建 一 个 名 为 .github.io 的 版 本 库 ， 向 其 master 分 支 提交 网 站 静态 页 面 
其 中 网 站 首页 为 index.html。 下 面 以 gotgithub 用 户 为 例 介 绍 如 何 创建 个 人 主页 。 


e 用 户 gotgithub 创 建 一 个 名 为 gotgithub.github.io 的 Git 版 本 库 。 
在 GitHub 上 创建 版 本 库 的 操作 ， 参 见 “ 第 3.1 节 创建 新 项 目 ” 


在 本 地 克隆 新 建立 的 版 本 库 。 


git clone git@github.com:gotgithub/gotgithub.github.io.git 
cd gotgithub.github.io/ 


HH 


在 版 本 库 根 目录 中 创建 文件 index.html 作 为 首页 。 


€ 


printf "«hi»2GotGitHub's HomePage</h1>It works.n" > index.html 


git add index.html 
git commit -m "Homepage test version." 


HH 


e 推送 到 GitHub， 完 成 远程 版 本 库 创 建 。 


{tp 


git push origin master 


e 仿 问 网 址 : http://gotgithub.github.io/ ° 


最 多 等 待 10 分 钟 ，GitHub 就 可 以 完成 新 网 站 的 部 署 。 网 站 完成 部 署 后 版 本 库 的 所 有 者 会 
收 到 邮件 通知 。 


还 有 要 注意 访问 用 户 二 级 域名 的 主页 要 使 用 HTTP 协 议 非 HTTPS 协 议 。 


3.5.2. 创建 项 目 主 页 
如 前 所 述 ，GitHub 会 为 每 个 账号 分 配 一 个 二 级 域名 .github.io 作 为 用 户 的 首页 地 址 。 实 际 上 还 
可 以 为 每 个 项 目 设置 主页 ， 项 目 主页 也 通过 此 二 级 域名 进行 访问 。 


例如 gotgithub 用 户 创建 的 helloworld 项 目 如 果 启 用 了 项 目 主页 ， 则 可 通过 网 址 
http://gotgithub.github.io/helloworld/77 I7] » 


为 项 目 局 用 项 目 主页 很 简单 ， 只 需要 在 项 目 版 本 库 中 创建 一 个 名 为 gh-pages 的 分 支 ， 并 向 其 
中 添加 静态 网 页 即 可 。 也 就 是 说 如 果 项 目的 Git 版 本 库 中 包含 了 名 为 gh-pages 分 支 的 话 ， 则 表 
明 该 项 目 提供 静态 网 页 构成 的 主页 ， 可 以 通过 网 址 http://.github.io/ 访 同 到 。 


下 面 以 用 户 gotgithub 的 项 目 helloworld 为 例 ， 介 绍 如 何 维 护 项 目 主页 。 


如 果 本 地 尚未 从 GitHub 克 隆 helloworld 版 本 库 ， 执 行 如 下 命令 。 


$ git clone gitQgithub.com:gotgithub/helloworld.git 
$ cd helloworld 


当前 版 本 库 只 有 一 个 名 为 master 的 分 支 ， 如 果 让 接 从 master 分 支 创建 gh-pages 分 支 操 作 非 党 
简单 ， 但 是 作为 保存 网 页 的 gh-pages 分 支 中 的 内 容 和 master 分 支 中 的 可 能 完全 不 同 。 如 果 不 
希望 gh-pages 分 支 继承 master 分 支 的 历史 和 文件 ， 即 想 要 创建 一 个 干净 的 gh-pages 分 支 ， 需 
要 一 点 小 技巧 。 


若 使 用 命令 行 创建 干净 的 gh-pages 分 支 ， 可 以 从 下 面 三 个 方法 任 选 一 种 。 
第 一 种 方法 用 到 两 个 Git 底 层 命令 : git write-tree 和 git commit-tree » 7 to F : 


e 基于 master 分 支 建立 分 支 gh-pages。 
$ git checkout -b gh-pages 
e 出 除 暂 存 区 文件 ， 即 相当 于 清空 暂 存 区 。 


$ rm .git/index 


e 创建 项 目 首页 index.html。 


€ 


printf "hello world.*n" > index.html 


e 添加 文件 index.html 到 暂 存 区 。 


{tp 


git add index.html 


e 用 Git 底 层 命 令 创建 新 的 根 提 交 ， 并 将 分 支 gh-pages 重 置 。 
$ git reset --hard $(echo "branch gh-pages init." | git commit-tree $(git write-tree)) 
e 执行 推送 命令 ， 在 GitHub 远 程 版 本 库 创 建 分 支 gh-pages。 


$ git push -u origin gh-pages 


第 二 种 方法 用 到 Git 底 层 命 令 : git symbolic-ref。 步 骤 如 下 : 


e 用 git symbolic-ref 命 令 将 当前 工作 分 支 由 master 切 换 到 一 个 尚 不 存在 的 分 支 gh-pages 。 
$ git symbolic-ref HEAD refs/heads/gh-pages 

e 删除 暂 存 区 文件 ， 即 相当 于 清空 暂 存 区 。 

$ rm .git/index 


e 创建 项 目 首 页 index.html。 


$ printf "hello world.*n" > index.html 


e 添加 文件 index.html 到 暂 存 区 。 
$ git add index.html 
e 执行 提交 。 提 交 完 毕 分 支 gh-pages 完 成 创建 。 
$ git commit -m "branch gh-pages init." 
e 执行 推送 命令 ， 在 GitHub 远 程 版 本 库 创 建 分 支 gh-pages。 
$ git push -u origin gh-pages 
第 三 种 方法 没有 使 用 任何 Git 底 层 命令 ， 是 从 另外 的 版 本 库 获取 提交 建立 分 支 。 操 作 如 下 : 
e 在 helloworld 版 本 库 之 外 创建 另外 一 个 版 本 库 ， 例 如 helloworld-web 。 


$ git init ../helloworld-web 
$ cd ../helloworld-web 


e 在 helloworld-web 版 本 库 中 创建 主页 文件 index.html。 


$ printf "hello world.*n" > index.html 


e 添加 文件 index.html 到 暂 存 区 。 


$ git add index.html 


实际 提交 到 master 分 支 ， 虽 然 提交 说 明 中 出 现 的 是 gh-pages 。 
g g 


$ git commit -m "branch gh-pages init." 


e 切换 到 helloworld 版 本 库 目 录 。 


$ cd ../helloworld 


e 从 helloworld-web 版 本 库 获取 提交 ， 并 据 此 创建 gh-pages 分 支 。 


$ git fetch ../helloworld-web 
$ git checkout -b gh-pages FETCH HEAD 


e 执行 推送 命令 ， 在 GitHub 远 程 版 本 库 创 建 分 支 gh-pages » 


$ git push -u origin gh-pages 


无 论 哪 种 方法 ， 一 旦 在 GitHub 远 程 版 本 库 中 创建 分 支 gh-pages， 项 目的 主页 就 已 经 建立 。 稍 
后 〈 不 超过 10 分 钟 ) ， 用 浏览 器 访问 下 面 的 地 址 即 可 看 到 刚刚 提交 的 项 目 首页 : 
http://gotgithub.github.io/helloworld/ ° 


除了 以 上 通过 命令 行 创建 gh-pages 分 支 为 项 目 设 定 主页 之 外 ，GitHub 还 提供 了 图 形 操 作 界 
面 。 如 图 3-19 所 示 。 
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图 3-19 : 项 目 管理 页 面 中 的 GitHub Pages 选 项 


当 在 项 目 管 理 页 面 中 色 选 “GitHub Pages” 选 项 ， 并 按照 提示 操作 ， 会 自动 在 项 目 版 本 库 中 创建 
gh-pages 分 支 。 然 后 执行 下 面 命 令 从 版 本 库 检 出 gh-pages 分 支 ， 对 项 目 主页 进行 相应 定制 。 


$ git fetch 
$ git checkout gh-pages 


3.5.3. 使 用 专 有 域名 


无 论 是 用 户主 页 还 是 项 目 主页 ， 除 了 使 用 github.com 下 的 二 级 域名 访问 之 外 ， 还 可 以 使 用 专 有 

域名 。 实 现 起 来 也 非常 简单 ， 只 要 在 master 分 支 (用 户主 页 所 在 版 本 库 ) 或 gh-pages 分 支 
(项 目 版 本 库 ) 的 根 目 录 下 检 入 一 个 名 为 CNAME 的 文件 ， 内 容 为 相应 的 专 有 域名 。 当 然 还 要 

更 改 专 有 域名 的 域名 解析 ， 使 得 该 专 有 域名 的 IP 地 址 指向 相应 的 GitHub 二 级 域名 的 IP 地 址 。 


例如 worldhello.net("Hello, world” 最 为 程序 员 所 熟知 ，2002 年 申请 不 到 helloworld 相 关 域 名 便 
退 而 求 其 次 ， 申 请 了 worldhello.net。) 是 我 的 个 人 网 站 ， 若 计划 将 网 站 改 为 由 GitHub 托 管 ， 并 
由 账号 gotgit 通 过 个 人 主页 提供 服务 ， 可 做 如 下 操作 。 


首先 按照 前 面 章节 介绍 的 步骤 ， 为 账号 gotgit 设 置 账户 主页 。 
1. 在 账户 gotgit 下 创建 版 本 库 gotgit.github.io 以 维护 芒 账 号 主页 。 
地 址 : https://github.com/gotgit/gotgit.github.io/ 
2. 将 网 站 内 容 提 交 并 推送 到 该 版 本 库 master 分 支 中 。 


即 在 gotgit.github.io 版 本 库 的 根 目 录 下 至 少 包 含 一 个 首页 文件 ， 如 index.html。 还 可 以 使 
用 下 节 将 要 介绍 到 的 Jekyll 技术 ， 让 网 页 有 统一 的 显示 风格 ， 此 时 首页 文件 可 能 并 非 一 
个 完整 的 HTML 文 档 ， 而 是 套用 了 页 面 模版 。 


3. 至 此 当 访 问 网 址 http://gotgit.github.io 时 ， 会 将 账号 gotgit 的 版 本 库 gotgit.github.io 中 的 内 容 
作为 网 站 内 容 显 示 出 来 。 


接 下 来 进行 如 下 操作 ， 使 得 该 网 站 能 够 使 用 专 有 域名 www.worldhello.net 提 供 服 务 。 


1. 在 账号 gotgit 的 版 本 库 gotgit.github.io 根 目录 下 添加 文件 CNAME， 文 件 内 容 为 : 
www.worldhello.net ° 


参见 : https://github.com/gotgit/gotgit.github.io/blob/master/CNAME 


2， 然 后 更 改 域 名 www.worldhello.net 的 IP 地 址 ， 指 向 域名 gotgit.github.io 对 应 的 IP 地 址 (注意 
不 是 github.com 的 IP 地 址 ) 。 


完成 域名 的 DNS 指 向 后 ， 可 试 着 用 ping 或 dig 命 令 确认 域名 www.worldhello.net 和 
gotgit.github.io48 19 E] —IP X3 » 


$ dig 08.8.8.8 -t a www.worldhello.net 


; ANSWER SECTION: 
www.worldhello.net. 81078 IN A 204.232.175.78 


$ dig 08.8.8.8 -t a gotgit.github.io 


; ANSWER SECTION: 
gotgit.github.io. 43200 IN A 204.232.175.78 


设置 完成 后 用 浏览 器 访问 http://www.worldhello.net/ 即 可 看 到 由 账号 gotgit 的 版 本 库 
gotgit.github.io2E 4^ &j 3i m » 27 3$ 33/2 worldhello.net (不 带 wwwW 前 级 ) 也 指向 IP 地 址 
204.232.175.78， 则 访问 网 址 http://worldhello.net/ 会 发 现 GitHub 体 贴 地 将 该 网 址 重 定 向 到 正 
确 的 地 址 http://www.worldhello.net/。 


在 账号 gotgit 下 的 其 他 版 本 库 ， 若 包含 了 gh-pages 分 支 ， 亦 可 由 域名 www.worldhello.net 访 问 
到 o 


e 网 址 http://www.worldhello.net/doc 实际 对 应 于 版 本 库 gotgit/doc ° 
e 网 址 http://www.worldhello.net/gotgit 实际 对 应 于 版 本 库 gotgit/gotgit ° 
e 网 址 http://www.worldhello.net/gotgithub 实际 对 应 于 版 本 库 gotgit/gotgithub ° 


3.5.4. 使 用 Jekyll 维 护 网 站 


Jekyll 是 一 个 支持 Textile、Markdown 等 标记 语言 的 静态 网 站 生成 软件 ， 还 支持 博客 和 网 页 模 
版 ， 由 Tom Preston-Werner (GitHub 创 始 人 之 一 ) 开发 。Jekyll 用 Ruby 语 言 实 现 ， 项 目 在 
GitHub 的 托管 地 址 : http://github.com/mojombo/jekyll/ ， 专 有 的 URL 地 址 

为 : http://jekyllrb.com/ ° 


GitHub 为 用 户 账号 或 项 目 提 供 主页 服务 ， 会 从 相应 版 本 库 的 master 分 支 或 gh-pages 分 支 检 出 
网 页 文件 ， 然 后 执行 Jekyll 相应 的 命令 对 网 页 进行 编译 。 因 此 在 设计 GitHub 的 用 户主 页 和 项 
目 主页 时 都 可 以 利用 Jekyll， 实 现 用 Markdown 等 标记 语言 撰写 网 页 及 博客 ， 并 用 页 面 模版 实 
现 网 页 风格 的 统一 。 


e xx A 
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$ gem install jekyll 


如 果 安 装 过 程 因 编译 扩展 模 组 遇 到 错误 ， 可 能 是 因为 尚未 安装 所 需 的 头 文件 ， 需 要 进行 如 下 
操作 : 


e 对 于 Debian Linux、Ubuntu 等 可 以 用 如 下 方法 安装 所 需 软 件 包 : 


$ sudo apt-get install ruby1.8-dev 


e 如 果 是 Red Hat、CentOS 或 Fedora 等 系统 ， 使 用 如 下 命令 安装 : 


$ sudo yum install ruby-devel 


e *j T Mac OSX， 可 能 需要 更 新 RubyGems， 如 下 : 


$ sudo gem update --system 


Jekyll 安 装 完 毕 ， 执 行 下 面 的 命令 显示 软件 版 本 : 


$ jekyll -v 
Jekyll 0.11.0 


要 学 习 如 何 用 Jekyll 设 计 网 站 ， 可 以 先 看 一 下 作者 Tom Preston-Werner 在 GitHub 上 的 个 人 网 站 
是 如 何 用 Jekyll 制 作出 来 的 。 


克隆 版 本 库 : 


$ git clone git://github.com/mojombo/mojombo.github.com.git 


版 本 库 包 含 的 文件 如 下 : 


$ cd mojombo.github.com 

$ ls -F 

CNAME  config.yml | posts/ css/ index.html 
README.textile _layouts/ atom.xml images/ random/ 


版 本 库 根 目录 下 的 index.html 文 件 不 是 一 个 普通 的 HTML 文 件 ， 而 是 使 用 Liquid 模 版 语言 [2] 定 
义 的 页 面 。 


1 
layout: default 
title: Tom Preston-Werner 


«div Id= "home > 
<h1>Blog Postsc/h1» 
«ul class="posts"> 
9 {% for post in site.posts 96) 
10 <li><span>{{ post.date | date to string ))«/span» &raquo; «a href="{{ post.url } 
11 {% endfor %} 
12 </ul> 


63 </div> 





为 方便 描述 为 内 容 添 加 了 行 号 ， 说 明 如 下 : 


e 第 1-4 行 是 YAML 格 式 的 文件 头 ， 设 定 了 该 文件 所 使 用 的 模版 文件 及 模版 中 要 用 到 的 变 


€ 


Oo 


里 


凡是 设置 有 YAML 文 件 头 的 文件 (目录 layouts 除 外 ) 无 论文 件 扩展 名 是 什么 ， 都 会 在 
Jekyll 编 译 时 进行 转换 。 若 源 文 件 由 Markdown 等 标记 语言 撰写 〈 扩 展 名 为 .md、.textile 
等 ) ，Jekyll 还 会 将 编译 后 的 文件 还 将 以 扩展 名 .html 来 保存 。 


e 其 中 第 2 行 含义 为 使 用 default 模 版 。 
对 应 的 模版 文件 为 layouts/default.html 。 
e 第 3 行 设 定 本 页 面 的 标题 。 
在 模版 文件 layouts/default.html 中 用 {{ page.title 分 语法 获 入 所 设置 的 标题 。 下 面 是 模版 


文件 中 部 分 内 容 : 


<head> 
«meta http-equiv-"content-type" contentz"text/html; charset-utf-8" /> 
<title>{{ page.title ))«/title» 


e 第 6 行 开 始 的 内 容 绝 大 多 数 是 标准 的 HTML 语 法 ， 其 中 夹杂 少量 Liquid 模 版 特有 的 语法 。 


。 第 9 行 和 第 11 行 ， 对 于 有 着 Liquid 或 其 他 模版 编程 经 验 的 用 户 ， 不 难 理解 其 中 出 现 的 
由 (9%" 和 "96}" 标 识 的 指令 是 一 个 循环 指令 (for 循环 ) ， 用 于 逐条 对 博客 进行 相关 操作 。 


e 第 10 行 中 由 {人 和 中 "标识 的 表达 式 则 用 于 显示 博文 的 日 期 、 链 接 和 标题 。 


非 下 划 线 (0) 开头 的 文件 (包括 子 目 录 中 文件 ) ， 如 果 和 包含 YAML 文 件 头 ， 就 会 使 用 Jekyll 
进行 编译 ， 并 将 编译 后 的 文件 复制 到 目标 文件 夹 (默认 为 site 目录) 下 。 对 于 包含 YAML 文 
件 头 并 用 标记 语言 Markdown 等 撰写 的 文件 ， 还 会 将 编译 后 的 文件 以 ,html 扩展 名 保存 。 而 以 


下 划 线 开头 的 文件 和 目录 有 的 直接 忽略 不 予 处 理 (如 layouts 、 site B X X) ， 有 的 则 需 
要 特殊 处 理 (如 post 目录 ) 。 


目录 _post 用 于 保存 博客 条 目 ， 每 个 博客 条 目 都 
以 &lt;YYYY&gt; -&1t;MM&gt; -&1t;DD&gt; -&lt;blog- ENG 格式 的 文件 名 命名 。 扩 展 名 为 .md 
的 为 Markdown 格 式 ， 扩 展 名 为 .textile 的 为 Textile 格 式 。 这 些 文件 都 包含 类 似 的 文件 头 : 


layout: post 
title: How I Turned Down $300,000 from Microsoft to go Full-Time on GitHub 


即 博 客 使 用 文件 _1layouts/post.html 作为 页 面 模版 ， 而 不 是 index.html 等 文件 所 使 用 
的 1layouts/default.html 模版 。 这 些 模 版 文件 都 采用 Liquid 模 版 语法 。 保 存 于 post 目 录 下 的 
博客 文件 编译 后 会 以 &1t;YYYY&gt;/&1lt;MM&gt;/&1t;DD&gt;/&1t;blog-title&gt;.html 文件 名 保 


存在 输出 目录 中 。 


在 根 目 录 下 还 有 一 个 配置 文件 _config.yml 用 于 和 履 盖 Jekyll 的 默认 设置 ， 例 如 本 版 本 库 中 的 设 
Ee 


markdown: rdiscount 
pygments: true 


第 1 行 设置 使 用 rdiscount 软 件 包 作为 Markdown 的 解析 引擎 ， 而 非 默 认 的 Maruku。 第 2 行 开户 
pygments 支 持 。 对 于 中 文 用 户 强烈 建议 通过 配置 文件 _config.yml 重 设 markdown 解析 引擎 ， 
默认 的 Maruku 对 中 文 支持 不 好 ， 而 使 用 rdiscount 或 kramdown 均 可 。 关 于 该 配置 文件 的 更 
多 参数 详 见 Jekyll 项 目 维 基 [3] 。 


编译 Jekyll 编 辑 网 站 只 需 在 根 目 录 执 行 jekyll 命 令 ， 下 面 的 命令 是 GitHub 更 新 网 站 所 使 用 的 默认 
指令 。 


$ jekyll --pygments --safe 


现在 执行 这 条 命令 ， 就 会 将 整个 网 站 创建 在 目录 sitet ° 
果 没 有 安装 Apache 等 Web 服 务 器 ， 还 可 以 使 用 Jekyll 的 内 置 Web 服 务 器 。 
$ jekyll --server 


默认 在 端口 4000 开 启 Web 服 务 器 。 
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This is à guest post from Mathan de Vries. 


l've never really been a fan of gilk, but early on when | started using Git I 
found a tool called tig. It's available in MacPorts and Ubuntu (since 
Gutsy) through apt-get install tig. Tig provides a simple 
command-line yet ... 





图 3-20 : Git Ready 网 站 


你 相信 这 是 一 个 用 Jekyll 制 作 的 网 站 么 ?看 看 该 网 站 对 应 的 |P， 会 发 现 其 指向 的 正 是 GitHub。 
研究 GitHub 上 gitready 用 户 托 管 的 版 本 库 ， 会 发 现 en 版 本 库 的 gh-pages 分 支 负责 生成 
gitready.com 网 站 ，de 版 本 库 的 gh-pages 分 支 负 责 生 成 德 文 网 站 de.gitready.com， 等 等 。 而 
gitready 版 本 库 则 是 各 种 语种 网 站 的 汇总 。 


我 的 个 人 网 站 也 使 用 Jekyll 构 建 并 托管 在 GitHub 上 ， 网 址 : http://www.worldhello.net/。 


4. 工作 协同 


项 目 落户 GitHub 后 ， 一 定 希 望 有 越 来 越 多 的 人 能 参与 其 中 。GitHub 提 供 了 包括 传统 的 问题 追 
宗 系统 、 维 基 ， 还 包括 了 分 布 式 版 本 控制 系统 特有 的 协同 工具 。 


4.1. Fork + Pull 模 式 


和 参与 GitHub 中 的 项 目 开 发 ， 最 常用 和 推荐 的 首选 方式 是 “Fork + Pull 4€ X » #“Fork + Pull" 
式 下 ， 项 目 参 与 者 不 必 向 项 目 创建 者 申请 提交 权限 ， 而 是 在 自己 的 托管 空间 下 建立 项 目的 派 
生 (Fork) œ 


如 果 一 个 开源 项 目 派生 出 另外 的 项 目 ， 通 第 意味 着 项 目的 分 裂 和 开发 团队 的 齐 弱 ， 而 GitHub 
中 的 项 目 派 生 则 不 会 ， 而 且 正 好 相反 ，GitHub 中 的 项 目 派 生 是 项 目 壮大 的 体现 。 所 有 的 派生 
项 目 都 会 有 链接 指向 原始 项 目 ， 派 生 项 目 没 有 独立 的 缺陷 追踪 系统 (ISSUE) ， 而 是 必须 利 
用 创建 者 本 人 的 项 目 中 的 缺陷 追踪 系统 。 至 于 在 派生 项 目 中 创建 的 提交 ， 可 以 非常 方便 地 利 
用 GitHub 的 Pull Request 工 具 向 原始 项 目的 维护 者 发 送 Pull Request ? 

下 面 以 GotGit 版 本 库 为 例 ， 介 绍 如 何 利 用 GitHub 提 供 的 Fork 和 Pull Request 工 具 实 现 工作 协 

同 。 


4.1.1. 版 本 库 派 生 


GotGit 版 本 库 [1] 用 于 维护 《Git 权 威 指南 》 一 书 的 官网 和 勘误 ， 下 面 演示 的 勘误 表 修 改 是 由 王 
胜 [2] 通 过 GitHub 之 外 的 一 个 缺陷 追踪 平台 报告 的 [3]。 他 在 报告 中 ， 甚 至 和 直接 用 GNU diffs X 
告诉 我 该 如 何 修 改 。 


下 面 就 以 用 户 gotgithub 身 份 ， 访 问 版 本 库 https://github.com/gotgit/gotgit/ ， 添 加 新 的 勘误 。 
如 图 4-1 所 示 ，gotgit 项 目 在 之 前 的 示例 中 已 经 被 我 们 关注 但 尚未 Fork。 
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Code Nurses à Pull Roque RES BUE i Sinis A Graphs 


RER gabt ga n. com e 


i iona in Mac L*3 ZIP HTTP GH Aesd-Örty tr ] | tg jai i r. Pead-Onh 


K 4-1 : / gotgit^& H 


点 击 项 目 名 称 右 侧 的 Fork 按 钮 ， 便 在 gotgithub 用 户 自己 的 托管 空间 下 创建 项 目 派 生 ， 派 生 项 
目 版 本 库 出 现在 版 本 库 列表 中 ， 如 图 4-2。 


Your Repositories (3) New repository 





All Repositories Public Private Sources Forks 
© gotgithub/helloworld 


&) gotgithub/gotgithub.github.com 


© gotgithub/gotgit 


图 4-2 : gotgithub 用 户 的 项 目 列表 


访问 派生 后 的 版 本 库 ， 会 发 现 和 派生 前 的 几乎 相同 ， 除 了 没有 缺陷 跟踪 (ISSUE) ， 以 及 标 
识 了 该 项 目 派生 之 前 的 原 路 径 等 。 如 图 4-3 所 示 。 





| pin j Fark i Pul Meg rei ad ü 
Code hHetwo Pull Fegquests i Wiki Tiris & Graphs 
htlp ^w. osaxpn.com/doo/gotgit 
i Cone in Mac Lj ZIP ESH — HTTP  GHfexd-Ünh  gjitEgithut n:gotgithub/gotgit.gi! vr. ResdaWriág «coss 


E 4-3 : 派生 的 gotgit 项 目 
现在 gotgithub 用 户 就 在 本 地 派生 的 版 本 库 中 提交 。 


。 克隆 gotgithub/gotgit 版 本 库 。 


$ git clone gitQgithub.com:gotgithub/gotgit.git 
$ cd gotgit 


e 为 了 向 问题 的 发 现 者 致敬 ， 并 经 王 胜 同意 ， 以 他 的 身份 进行 提交 。 


$ git config user.name "Wang Sheng" 
$ git config user.email wangshengQossxp.com 


e 编辑 errata.mkd 文 件 ( 版 本 库 gotgit/gotgit 已 将 勘误 文件 重 命名 为 errata.md。)， 录 入 新 发 
现 的 书 中 的 文字 错误 。 


$ vi errata.mkd 


e 对 errormkd 的 改动 如 下 : 


$ git diff 

diff --git a/errata.mkd b/errata.mkd 
index b0b68fb..29e40cf 100644 

--- a/errata.mkd 

+++ b/errata.mkd 

QQ -14,5 +14,6 QQ 


| 66 | 倒数 第 11 行 | Author (提交 者 ) | Author (作者 ) 

| 144 | #147 | C$ **git rev-parse A^{tree} A:** | $ **git rev 

| 218 | 第 8 行 | A&T:GitsiásiRd e 3X: | 况 下 ，Git 标 识 出 合 
+| 369 | 第 21 行 | 但 “-i” 参 数 仅 当 对 一 个 项 执行 时 才 有 效 。 | 但 `“-i” 参 数 仅 当 

| 516 | 倒数 第 15 行 | **oldtag-"'cat"** | **oldtag-N' catN ^ ** 





z -— 
e 提交 修改 。 至 于 提交 说 明 中 出 现 的 编号 ， 是 为 了 和 缺陷 跟踪 系统 关联 ， 会 在 后 面 章节 介 


绍 。 


$ git add -u 
$ git commit -m "Fixed #3: should be 项 目 ，not 项 ." 


e 推送 提交 到 GitHub。 


$ git push 


访问 GitHub 上 的 派生 项 目 页 面 ， 会 看 到 以 用 尸 whangsheng 在 master 分 支 [5] 创 建 的 提交 。 如 
图 4-4 所 示 。 


Mis bar 
Fixed FA: shoud be BE. ma H 


W"5 wangaheng 


图 4-4 : 派生 版 本 库 中 的 新 提交 


4.1.2. Pull Request 


那么 如 何 能 够 让 gotgit 原 始 项 目的 创建 者 知道 这 个 派生 项 目 及 新 的 提交 呢 ? GitHub 提 供 的 工具 
就 是 "Pull Request”。 注 意 到 图 4-3 右 上 方 “Pull Request" 按 钮 了 么 ?点 击 该 按钮 进入 Pull 
Request 创 建 界 面 。 


在 弹出 的 Pull Request 创 建 界 面 中 ， 点 击 菜单 中 的 “Commits”， 查 看 所 包含 的 提交 。 如 图 4-5 所 
To 


Got Github 


3 gotgihub gotgit 


"S irion irom gotgitlgotga 


gotgit = Send a pull request 


You're asking *  getgit to pull 1 commit into 





Showing 1 unique commit by 1 author 


Fecdferaá m wangsheng Fixed £3: should be MA, not M. 8 minutes ago 


E 4-5 : Pull Request & 2 $7 4€ 3: 


点 击 菜单 中 的 “Files Changed”， 查 看 所 包含 的 提交 。 如 图 4-6 所 示 。 


a gotgithub / gotgit 


"2 kad hom pigg 


gotgit « Send a pull request 
You're asking T getgit to pull 1 commit into | gotgit:master | from ot gi thub:master | Change Commits 


a Preview Discussion < Commis 1f »: Filles Changed 1 
| 


Sheawing 1 changed fles wit 1 addiboóna and O deletion. 


La errata. mkd 


| BEATE 
errota. mkd Vurw e d acdiaT 
Bë -14,5 14,6 d 
| di | fERIITS | Author (593441 | Autbor (Ep | [Githubé2](httpr//githu 
| 144 | Muf | Vg **git rev-parse A^[tres) Ar** | $ **git rev-parse Aftree} A:1** 
| 218 | Mati | AF: GitskQUETEREPER. | RT. GitlHUETS RR. | 
*| 369 | M2177 | ^-^ M£MEDQENH—TAMUGINITSS. | 但 “= SSEXXH—TIRBEHSGONITS. | [eli 
| 516 | AEH | *"oldtage"cat"** | *"oldtageV cati ^u» | [£151](http://redmizk 


D+ xb , TP: You can add notes io lines in a file. 
| Haver to the left of a line io make a note 


图 4-6 : Pull Request 包 含 的 改动 差异 


点 击 菜 单 中 的 “Preview Discussion" > ?& 5 Pull Request 的 标题 和 内 容 ， 完 成 Pull Request 的 创 
建 。 如 图 4-7 所 示 。 


gotgit = Send a pull request 


| 


erii iom | 


aP Preview Discussion [£* Commits 1 5: Filles Changed 1 


You're asking T goigit io pull 1 commit into | 





Chenga Commis 


Wia -Proview Commanis ara parad wih Geb Flacred Marion © tpg 

Find a typo in th book 
|| PEOPLE TO BE MOTIFIED 
RD [onurad in thé book, ses my cómrmit. ;-] 


NE Iangxin 


HE ossxp-com 











4.1. Fork + Pulli X 64 


Got Github 


E 4-7 : Pull Request 的 提交 界面 


2: Pull Request 发 出 后 ， 项 目 gotgit 的 开发 者 会 收 到 通知 邮件 ， 如 图 4-8 所 示 。 


.. |getgit] Find a typo in the book (44) 





HH = | =+ M jam | BH | 
x getgahub cneph«i- 1413164-4 Tic 3705 ABcfddTe Te Zefc6aTadPse 2c T Tid Erepisy gisthiub com» H AERE) CLE d E! d a S It . 
iP dgntgit] Find à mpa ba ihe baak (a4) TET 


RE Kang Xin 9 HAE 


Hew typo found in the book, see my commit. @ 


Reply to this email directly ar view it on GitHub: 
https://github.com/gotgit/gotgit/pull/4 


M:LLILILÍLÉIÉLIÉ M MÀÓM———————ÓÓÜ———————ÀÓÓ—————— 


El 4-8 : Pull Request 的 通知 邮件 


点 击 邮 件 中 的 URL 链 接 ， 以 项 目 gotgit 的 开发 者 (如 0SSXp-com) 身份 登录 ， 看 到 如 图 4-9 的 视 
图 。 之 所 以 看 到 有 两 个 用 户 参与 到 此 Pull Request， 是 因为 Pull Request 创 建 者 和 提交 的 作者 
是 不 同 的 用 户 。 图 4-9 下 方 的 表单 可 以 向 Pull Request 追 加 评论 ， 或 者 关闭 此 Pull Request 


& gotgit / gotgit 4'Admin — 4 üewaich gj Fork — in Pull Request — 36 48 
Coda Ne tarh, PulReguesta 1 [ET J Wü) Ò Tiaia & Graphs 
E gotgithub warta someone to merge 1 commit into ET "m 
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gasgrimub opened mus puli eques B rines aga 


Find a typo in the book 








*1adiióan 
Naw typ fourid in the book, eee my commit. ;-] - D delalion 
E ub gotgithub and wangeheng ane participaling in this pull request AJ Pall Put 
"3 d wangahenmg added some commits 2 annus agri 
TecdFe7 WÜ Fixed K3: should be MA, not F. dts 
(ümMephme temm mee ym Er J 


É Corm mint on ihis pull ragasi (Help) Clase pull request 


Commaernis ara praod wir Bib Flawvered Marido 








£p i à Tip: You car aiso add notes tro Hines Closes E comment er rea a Wha pial ragin 


"| changed in a He under DIT 





Fl 4-9 : Pull Request 接 收 者 视图 


4.1. Fork + Pull 模 式 65 


GitHub 如 果 检 测 到 Pull Request 中 包含 的 提交 直接 合并 ， 会 显示 自动 合并 的 提示 信息 ， 点 
击 图 4-9 中 提示 信息 中 的 自动 合并 按钮 ， 显 示 peri Ae o 


Preview the merge commit 





| ossxp-com (author) — Merge pull request #4 from gotgithuh/master 
16 minutes aga 





Find a typo in the book 


E 4-10 : Pull Request 的 通知 邮件 


A 3: "Confirm Merge" 4 42 PP Z », Pull Request 中 所 含 提交 的 自动 合并 。 自 动 合并 完成 后 ，Pull 
Request 页 面 下 方 会 以 评论 的 形式 出 现 相 关 提 示 ， 并 自动 关闭 Pull Request。 如 图 4-11 所 示 。 


£ J" Oi referenced this pull gussi rom a commit August 16. 2011 


&ciíiee ME Merge pull request f4 from gotgithub/master 


mm È ossxp-com merged commit &ciflee into Eee 
| Closed. È ossxp-com closed the pull request August 16, 2011 





| from | rcl T EM August 16, 2011 


E 4-11 : Pull Request X 堵 


4.1.3. 手工 合并 


Pull Request 提 供 的 自动 合并 显示 在 提交 日 志 中 是 什么 样子 的 呢 ? 以 用 户 Ossxp-com 和 身份 检 出 
版 本 库 ， 会 看 到 用 户 wangsheng 的 提交 已 经 合并 到 版 本 库 中 。 


$ git clone gitQgithub.com:gotgit/gotgit.git 

$ cd gotgit 

$ git log --graph -3 

commit 6cifiee152629fd2f8d00ebe92c27a32d068d756 
Merge: O00c6c4b 7ecdfe?7 

Author: OpenSourceXpress 


* 
| 
| 
| Date: Tue Aug 16 01:23:47 2011 -0700 

| 

| Merge pull request #4 from gotgithub/master 
| 

| Find a typo in the book 

| 

| commit 7ecdfe7451412cfb2e65bb47c12cf2162e21c841 
| Author: Wang Sheng 

| Date: Tue Aug 16 10:17:53 2011 +0800 

| 

| Fixed #3: should be %48, not 项 . 

| 


* commit O00c6c4bfab9824bd967440902ce87440f9e87852 
| Author: Jiang Xin 

| Date: Wed Aug 3 11:50:31 2011 +0800 

| 

| 


Change font color for stronger text from red to brown. 


可 以 看 出 GitHub 的 自动 合并 产生 了 一 个 合并 提交 ， 类 似 执 行 git merge --no-ff 命 令 。 也 就 是 说 
即使 用 户 wangsheng 的 提交 是 一 个 “ 快 进 式 提交 ”( 基于 gotgit/gotgit 版 本 库 最 新 提交 所 做 的 提 
AX) ， 也 要 产生 一 个 合并 提交 。 


可 能 有 人 并 不 喜欢 这 种 用 --no-ff 参 数 的 非 标 准 的 合并 方式 ， 因 为 这 种 合并 产生 了 一 个 多 余 的 提 
交 ， 可 能 增加 代码 评审 的 负担 。 若 要 取消 GitHub 的 自动 合并 也 很 简单 ， 因 为 Git 无 所 不 能 : 


$ git reset --hard HEAD^ # 回 退 一 个 提交 ， 即 回 退 到 当前 提交 的 第 一 个 父 提 交 


$ git rev-parse HEAD H 检查 是 否 正确 的 回 退 
00c6c4bfab9824bd967440902ce87440f9e87852 
$ git push -f # 强制 推送 回 退 的 master 分 支 


下 面 就 演示 一 下 当 收 到 他 人 的 Pull Request 后 ， 该 如 何 手动 合并 。 实 际 上 在 很 多 情况 下 ，Pull 
Request 所 含 提交 有 可 能 造成 合并 冲突 ， 那 样 的 话 GitHub 不 再 、 也 不 能 提供 自动 合并 功能 ， 就 
必须 采用 手工 合并 的 方式 。 


e 将 Pull Request 发 出 者 的 派生 版 本 库 添 加 为 一 个 新 的 源 。 


例如 收 到 来 自 gotgithub 用 户 的 Pull Request， 不 妨 以 gotgithub 为 名 添加 新 的 源 。 


$ git remote add gotgithub https://github.com/gotgithub/gotgit.git 


e 此 时 版 本 库 中 有 两 个 源 ， 一 个 克隆 时 自动 建立 的 origin， 另 外 一 个 就 是 新 增加 的 
gotgithub » 


$ git remote -v 

gotgithub https://github.com/gotgithub/gotgit.git (fetch) 
gotgithub https://github.com/gotgithub/gotgit.git (push) 
origin gitQgithub.com:gotgit/gotgit.git (fetch) 

origin gitQgithub.com:gotgit/gotgit.git (push) 


e 获取 远程 版 本 库 gotgithub 的 分 支 和 提交 。 


$ git fetch gotgithub 

From https://github.com/gotgithub/gotgit 
* [new branch] gh-pages -» gotgithub/gh-pages 
* [new branch] master -» gotgithub/master 


e 现在 除了 本 地 分 支 master 外 ， 还 有 若干 远程 分 支 ， 如 下 : 


~ 


$ git branch -a 

* master 
remotes/gotgithub/gh-pages 
remotes/gotgithub/master 
remotes/origin/HEAD -> origin/master 
remotes/origin/gh-pages 
remotes/origin/master 


e 将 远程 分 支 remotes/gotgithub/master〈 可 简写 为 gotgithub/master) 合并 到 当前 分 支 中 。 


$ git merge gotgithub/master 
Updating O00c6c4b..7ecdfe?7 
Fast-forward 
errata.mkd | JE 
1 files changed, 1 insertions(+), © deletions(-) 


e 查看 提交 说 明 ， 看 到 此 次 合并 没有 产生 不 必要 的 合并 提交 。 


git log --graph -2 

commit 7ecdfe7451412cfb2e65bb47c12cf2162e21c841 
Author: Wang Sheng 

Date: Tue Aug 16 10:17:53 2011 +0800 


Fixed £3: should be HA, not 7$. 
commit O0O0c6c4bfab9824bd967440902ce87440f96e87852 


Author: Jiang Xin 
Date: Wed Aug 3 11:50:31 2011 +0800 


-一 一 一 一 :+ 一 一 一 一 一 xt 


Change font color for stronger text from red to brown. 


。 将 合并 推送 到 GitHub 版 本 库 中 。 


$ git push 


4.1.4. 在 线 编辑 


GitHub 提 供 了 在 线 编辑 功能 ， 这 样 可 以 无 需 克 隆 版 本 库 、 无 需 使 用 Git 即 可 完成 对 版 本 库 中 文 


件 的 修改 ， 其 至 可 以 在 你 的 iPad 其 至 iPhone 上 完成 对 文件 的 修改 。 


以 gotgithub 账 户 身份 登录 GitHub， 访 问 之 前 派生 而 来 的 版 本 库 gotgithub/gotgit 中 的 文件 ， 例 
如 文件 errata.md( 版 本 库 gotgit/gotgit 已 重 构 。 分 支 gh-pages 中 文件 errata.md 文 件 来 自 于 原 


master 分 支 的 errata.mkd 文 件 ， 地 址 : https://github.com/gotgithub/gotgit/blob/gh- 
pages/errata.md)， 会 看 到 其 中 一 个 “Edit this file” 的 按钮 ， 如 图 4-12 所 示 。 
3 gotgithub f gotgit aF Admin E awalch É Fom a Pull Fiequest LX 5 
Code Network Puli Fieqguesta Wk mats & Graphs 
hittp cis dub cc D 
a Clone inm Mac LZ SH HTTP Git Raead-Only yi tla E hyl m:gaotgithub/gat! t DU Pad aire 


Filés Commit: Branches f lags 12 rant ora ^ gh-pages - 


gh-pagea 


nemovae top p element, which align menu and contents 


MB osaxp-com ed6c192 a3 
gotgqit / errata.md € 
1E B4 lines (63 sloc) 56.975 kh rw | blame history 


layout: master iiti HAE stylesheels: | "/"himlncheratàa css" 


图 4-12 : 浏览 自己 版 本 库 中 文件 


点 击 图 4-12 中 的 “Edit this file” 按 钮 ， 开 始 在 线 编 辑 文件 errata.md， 编 辑 器 还 支持 语法 加 充 ， 
如 图 4-13 所 示 。 


Files Commits Branche 2 Tags 34 i ^ ghepapges - 
gotgit / errata.md E Back to &ource vim 
7 Col Pries Spaces . 4 z No wrap 


layout: master 

title: DP E. 

stylesheets; [ "/homl/inc/errata.css" ] 

jevascripts: [ "/,javascripts/jquery.js", "html/inc/click more. Js" J 


|i b4 DIPPIXE JAEN TFHA : 
"E 3:ftil pl m 
1 MI J(nttps : //github.com/gotgit/gotgit/issues/nem) RE A M 


FEE [Esci F3 LIII. 








Edit errata.md directly on the web.| 





E 4-13 : 编辑 文件 


4.1.5. 简化 的 Fork + Pull Request 


到 目前 ， 我 们 已 经 了 解 了 GitHub 的 三 大 武器 : Fork ^ Pull Request 和 在 线 编辑 。 对 于 最 常用 
的 “Fork + Pull Request" 操 作 ，GitHub 还 提供 了 一 个 快捷 模式 。 即 GitHub 对 于 无 权 更 改 的 他 人 
版 本 库 中 的 文件 ， 提 供 了 一 个 类 似 在 线 编辑 的 按钮 ， 名 为 “Fork and edit this file” 按 钮 ， 自 动 完 
成 版 本 库 派生 和 在 线 编辑 ， 即 将 三 大 武器 一 勺 烩 。 


访问 他 人 版 本 库 (尚未 在 自己 空间 派生 ) 中 的 文件 ， 例 如 访问 下 面 地 址 : http://git.io/hello- 
world-makefile( 即 地 址 https://github.com/ossxp-com/hello-world/blob/master/src/Makefile) ° 
显示 他 人 (ossxp-com) 版 本 库 hello-world 中 的 src/Makefile 文 件 ， 如 图 4-14 所 示 。 


& ossxp-com / helloworld € Wah A Fork 1 i 


Files L:ommit Branches 3 rag: ^A master = 


magit 
Dika vergicwi 


a argxn le6B70eh28 


Licking ha buho wë puami y iori hi 


hello-world / src / Makefile E ——————À 





] eh 2S Limes (19 slg] g.475 kb 


图 4-14 : 浏览 他 人 版 本 库 中 文件 


点 击 图 4-14 中 的 “Fork and edit this file” 按 钮 ， 会 自动 在 自己 托管 空间 创建 派生 版 本 库 ， 并 开始 
在 线 编辑 文件 src/Makefile ， 如 图 4-15 所 示 。 


a ossxp-com / hello-world €» Unwateh — i YourFo — €»2 


Code Network Pull Ftéaue sT TET Sata & Graphs 


Files Commi Hranches 3 rag A master = 


. Octotip: You are editng ale in a project you do not have ariig access T0. Vie ane forking this proiect tor you [IT oe doas not yet existi do write your peoposad 
。 cnanges im. Submiding a change W this Tie will write itio a new branch m your fork so you can send a pull nequast 


hello-world / src / Makefile E Back t6 8ource view 


." Cee Pew Tabs : 5 : Mo wrad 


DEJELTS = moir. O 
TARGET = hello 


all: HTARGET} 


H TARGET): MORJECTS] 
HEC -0 M 


main.o: | mew header 
main.o: wersion.h 


new, header: 
üsed -e "scversiord$$(git describe --dirty --almays)Eg" < version.h.in » version.h.tmp 
Hf diff -q version,h, tmp version.h x/dev/null £51; then ™ 
rm version. h. tmp; * 





| Bugfix: build target when version.h changed. 


| 
(Without this fix, when version changed only version.h update, target rebuild needs a second "make'.| 


Cancel Propose File Change 


图 4-15 : 派生 并 编辑 文件 


文件 修改 完毕 ， 点 击 “Propose File Change” 按 钮 ， 会 将 改动 作 提交 到 派生 的 版 本 库 中 ， 并 马 
上 开 尼 一 个 新 的 Pull Request。 如 图 4-16 所 示 。 


& gotgithub / hello-world * BackisSoume ‘<1 2 
HE kd -Fu Jatan kei o S E 
halle-work] « Sand a pul request 


"JN. Octotip- The change you just mada was written 1o a new branch in your fork of this project namel parteh-1. 
- You may now send a pull eguet io te author of tfe orginal praject so They can review and merge it 





You're asking Pl ossxp-com to pull 1 commit Changa Camrmta 





aP Proview Discussion | 6» Commis ' — 33 Files Changed. ' 


A ossxp-com/helic-world 


Write Pire ra | merem NOD pT win 局 上 LU mage Haka 


Bugie build target when version.h changed 
| | | = PEOPLE TO BE NOTIFIED 
Without this Fix, when version changed only version h update, Large rebuild needs à second makr. 
NE ossxzp-com 


图 4-16 : 编辑 完毕 自动 开启 Pull Request 


点 击 “Send pull request” 按 钮 完成 Pull Request 的 创建 。 如 果 仔 细 查 看 图 4-16， 会 发 现 Pull 
Request 所 包含 的 修改 发 生 在 gotgithub/hello-world 派 生 版 本 库 中 的 patch-1 分 支 中 ， 并 非 通 常 
的 master 分 支 。 
原版 本 库 0ssxp-com/hello-world 的 开发 者 会 收 到 一 封 邮 件 ， 通 知 有 新 的 Pull Request， 如 下 所 
T (前 四 行为 信 藉 ) 
From: GotGitHub 
Date: 2011/12/17 
Subject: [hello-world] Bugfix: build target when version.h changed. (#1) 
To: Jiang Xin 
Without this fix, when version changed only version.h update, target rebuild needs a seco 
You can merge this Pull Request by running: 
git pull https://github.com/gotgithub/hello-world patch-1 
Or you can view, comment on it, or merge it online at: 
https://github.com/ossxp-com/hello-world/pull/1 
-- Commit Summary -- 
* Bugfix: build target when version.h changed. 
-- File Changes -- 
M src/Makefile (3) 
-- Patch Links -- 


https://github.com/ossxp-com/hello-world/pull/1i.patch 
https://github.com/ossxp-com/hello-world/pull/1.diff 


Reply to this email directly or view it on GitHub: 
https://github.com/ossxp-com/hello-world/pull/1i 


到 ER 





版 本 库 oOSSXp-com/hello-world 的 管理 员 既 可 以 通过 GitHub 提 供 的 图 形 化 界面 完成 对 Pull 
Request 的 审核 和 合并 ， 也 可 以 在 命令 行 下 完成 。 正 如 邮件 中 所 述 若 使 用 命令 行 ， 操 作 如 
F: 


$ git pull https://github.com/gotgithub/hello-world patch-1 


4.2. 共享 版 本 库 


除了 独 具 特 色 的 “Fork + Pul 的 分 布 式 工作 模式 ，GitHub 同 样 支持 传统 的 集中 式 协 同 工 作 模 
A. 


4.2.1. 版 本 库 授 权 


GitHub 可 以 通过 多 种 途径 为 版 本 库 授 权 ， 让 版 本 库 成 为 多 人 共享 的 版 本 库 ， 从 而 让 项 目 管理 
者 围绕 项 目 创建 一 个 核心 开发 团队 。 下 面 以 gotgithub 账 号 下 的 helloworld 版 本 库 为 例 ， 介 绍 如 
何 设 置 版 本 库 的 多 人 共享 。 


进入 gotgithub/helloworld 项 目的 管理 界面 ， 点 击 左 侧 导 航 条 中 的 “Collaborators”， 可 以 查看 及 
添加 项 目的 合作 者 ， 如 图 4-17 所 示 。 





E gotgitub i helloworld t Bach ta Saures AER 1 1 
Fee Ilocosikd denosip rd rr 1o 
Int 也 有 
- denas n 
Collaborators 1 
| dib Add Privaig collaborators are gitur 
Service Hooks In incredible your private rei 


Incredible; i 
incredibiebeet 


IncredibleDoes 
图 4-17 : 添加 项 目 合 作者 


图 4-17 为 项 目 添加 了 两 个 合作 者 : Supergirl 和 incredible。 添 加 到 项 目 当 中 的 合作 者 会 收 到 通 
知 邮 件 ， 告 知已 经 被 加 入 到 相应 的 项 目 当 中 。 当 新 加 入 的 项 目 合作 者 ， 如 incredible ， 登 录 
GitHub， 在 仪表 板 的 版 本 库 列表 中 会 看 到 源 自 gotgithub 用 户 的 版 本 库 ， 如 图 4-18 所 示 。 
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ISSUES News Feed 


Pull Requests Issues 
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All Repositories Public Private Sources Forks 


e» incredible/demo 
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图 4-18 : 合作 者 项 目 列表 


从 图 4-18 可 以 看 出 GitHub 用 户 incredible 自 己 创 建 的 项 目 托管 在 自己 的 空间 下 ， 而 作为 合作 者 
参与 的 项 目 仍然 托管 在 原创 建 者 〈gotgithub) 的 空间 下 ， 这 一 点 明显 和 派生 (Fork) 而 来 的 
项 目 不 同 。 图 4-19 是 以 incredible 登 录 GitHub 访 问 gotgithub/helloworld 的 界面 。 


E| : 
github Explore Gist Blog Help ia, Incredible ue x pB 
* gotgithub / helloworld €» Watch — (i Fork — iii Pull Request 
Code Network Pul Heguesis i v tas A C +" 
d Clone in Mac L ze 55H HITE GA Raxd-Ony ttps nécrediblesigi thub m/gotgtthub/hellowo W^] Peki Hirie acces 
Files Commits Branches 1 Tags 2 iGcho h master = 
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FS potant e71231cbdl 


E 4-19 : 以 合作 者 身份 访问 项 目 


用 户 incredible 对 版 本 库 gotgithub/helloworld 拥 有 写 入 权限 。 和 gotgithub 用 户 稍 有 区 别 的 是 没 
有 管理 员 权 限 。 


4.2.2. 与 传统 集中 式 工作 模式 的 异同 


传统 的 集中 式 版 本 控制 系统 ， 如 CVS、SVN， 所 有 用 户 都 访问 同一 个 版 本 库 。 采 用 集中 式 工 
作 模 式 的 GitHub 用 户 也 同样 是 访问 同一 版 本 库 。 


3} F à Fl] P gotgithubl x& 8j helloworld A AÈ > Ze T & tar supergirlfeincredible > — 4A. t 
隆 版 本 库 使 用 如 下 命令 8 


e 用 户 gotgithub 克隆 版 本 库 。 


gotgithub$ git clone https://gotgithubQgithub.com/gotgithub/helloworld.git 


e 用 户 Supergirl 克隆 版 本 库 。 


supergirl$ git clone https://supergirlQgithub.com/gotgithub/helloworld.git 


e 用 户 incredible 克隆 版 本 库 。 


incredible$ git clone https://incredibleQgithub.com/gotgithub/helloworld.git 


f SR, IPLA | A UL PLE IRANA AEAEE AE P” eA ERROR ETT 
8g» T Eub $78 P AE JEUNTR ILE sho RPAN f LALUL T AR $ GA o AAM AR 
辑 锁 的 形式 (如 VSS) ， 更 改 文件 前 对 文件 锁定 ， 其 他 人 茶 止 对 文件 进行 访问 《甚至 无 法 读 
取 ) ， 完 成 修改 并 提交 后 ， 文 件 解锁 。 有 的 如 SVN， 人 允许 多 人 同时 编辑 同一 文件 ， 但 只 有 先 
进行 提交 的 才能 成 功 ， 后 提交 的 会 遇 到 "过 时 "错误 ， 必 须 先 获取 版 本 库 中 的 新 增 提交 并 和 本 地 
修改 进行 合并 。 即 传统 集中 式 版 本 控制 系统 ， 提 交 时 必须 和 唯一 的 版 本 库 所 在 的 服务 器 保持 
连接 ， 而 且 提 交 有 可 能 会 失败 。 


对 于 像 Git 这 样 的 分 布 式 版 本 控制 系统 ， 提 交 总 是 会 成 功 ， 这 是 因为 提交 并 不 涉及 和 共和 至 服务 
器 的 交互 ， 是 针对 本 地 克隆 版 本 库 进行 的 本 地 操作 。 才 用 和 集中 式 的 工作 模式 ， 共 吾 版 本 库 作 
为 各 个 用 户 各 上 自 本 地 版 本 库 数 据 交换 、 沟 通 的 中 介 ， 只 有 在 本 地 元 隆 版 本 库 需 要 和 共 华 版 本 
库 同 步 的 时 候 才 要 和 服务 器 建立 连接 。 例 如 将 本 地 所 做 的 一 个 或 乡 个 提交 推送 到 共和 至 服务 

器 ， 或 者 将 服务 器 上 新 的 提交 获取 到 本 地 克隆 版 本 库 。 


实际 上 无 论 采 用 分 布 式 还 是 集中 式 的 工作 模式 ，Git 都 好 像 工 作 在 一 个 独立 的 分 支 上 《克隆 即 
分 支 ) ， 即 使 共享 版 本 库 和 本 地 克隆 版 本 库 的 分 支 名 都 叫做 master。 如 图 4-20， 三 个 用 户 克 
隆 gitgithub/helloworld 版 本 库 后 ， 各 自在 本 地 执行 了 一 次 或 多 次 提交 。 
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图 4-20 : 在 本 地 版 本 库 中 的 提交 


三 个 用 户 各 自 的 提交 都 会 非常 顺利 ， 但 是 一 旦 决定 将 本 地 提交 推送 到 共享 服务 器 时 就 可 能 遇 
$| M. | P gotgithub 先 执 行 推送 ， 会 非常 顺利 。 如 图 4-21 所 示 。 


gotgithub$ git push 








. €? 
gotgithub supergirl meredible 


Fl 4-21 : M P gotgithub Z 348 3€ 

而 其 他 人 就 没有 这 么 幸运 了 ， 会 报告 错误 : 遇 到 非 快 进 式 推送 。Git 的 推送 操作 就 像 SVN 等 集 
中 式 版 本 控制 系统 的 提交 操作 那样 ， 先 执行 者 成 功 ， 后 执行 者 糟糕 (要 解决 冲突 ， 自 动 或 手 
zy) 。 


D) 


G 


4.2.3. 合并 后 推送 


当 用 户 gotgithub 完 成 推送 后 ， 共 享 版 本 库 以 及 三 个 用 户 的 本 地 版 本 库 如 图 4-21 所 示 。 其 中 共 
享 版 本 库 变 得 和 gotgithub 用 户 的 本 地 版 本 库 相 一 致 。 此 时 如 果 用 户 supergirl 执 行 推 送 ， 会 遇 
到 错误 : 非 快 进 式 推 送 。 


supergirl$ git push 
To https://supergirlQgithub.com/gotgithub/helloworld.git 
! [rejected] master -> master (non-fast-forward) 
error: failed to push some refs to 'https://supergirlQgithub.com/gotgithub/helloworld.git 
To prevent you from losing history, non-fast-forward updates were rejected 
Merge the remote changes (e.g. 'git pull') before pushing again. See the 
'Note about fast-forwards' section of 'git push --help' for details. 


a| ESSE 





GitHub 并 不 对 强制 推送 进行 限制 ， 但 是 用 户 supergirl 不 要 用 git push -f 命 令 强 制 推送 ， 因 为 那 
样 会 禾 盖 挥 共 享 版 本 库 中 用 户 gotgithub 的 推送 ， 正 确 的 做 法 是 获取 共享 版 本 库 中 新 提交 ， 并 
在 本 地 版 本 库 中 和 本 地 提交 合并 。 即 执行 : 


supergirl$ git fetch 
supergirl$ git merge 


获取 和 合并 操作 过 程 如 图 4-22 所 示 。 





图 4-22 : 合并 操作 示意 图 
实际 上 用 户 supergirl| 只 需 执 行 一 条 命令 便 可 完成 所 有 的 操作 : 


supergirl$ git pull 


PP : git pull = git fetch + git merge ° 


但 是 合并 操作 并 不 总 是 会 成 功 ， 如 果 自 动 合并 失败 ， 会 在 暂 存 区 对 合并 前 后 文件 进行 标识 ， 
工作 区 进入 冲突 解决 状态 ， 在 冲突 解决 完成 之 前 不 能 提交 。Git 支 持 多 种 图 形 工具 帮助 完成 冲 
突 解决 ， 执 行 如 下 命令 ， 即 可 自动 调用 已 安装 的 冲突 解决 工具 。 


supergirl$ git mergetool 


冲突 解决 完毕 ， 执 行 提 交 即 完成 冲突 解决 。 如 果 在 冲突 解决 过 程 把 本 地 文件 搞 得 一 团 糟 ， 随 
时 可 以 取消 合并 操作 。 执 行 命令 git reset --hard 会 取消 冲突 的 合并 让 本 地 版 本 库 回 到 合并 之 前 
的 状态 。 


成 功 完 成 合并 后 将 本 地 版 本 库 中 的 提交 推送 到 共享 版 本 库 : 


supergirl$ git push 


完成 推送 后 的 版 本 库 示 意图 如 图 4-23 所 示 。 








uotalthub incredible 


图 4-23 : 完成 合并 后 推送 


4.2.4. 合计 还 是 变 基 


合并 并 非 多 个 开发 者 的 工作 成 果 融 合 的 唯一 选择 ， 有 时 甚至 并 非 最 佳 选择 。 一 方面 合并 会 产 
生 除了 合并 双方 (或 多 方 ) 所 有 提交 外 的 一 个 新 提交 ， 增 加 了 代码 审核 的 负担 ， 另 一 方面 本 
地 多 个 提交 混杂 一 起 与 远程 分 支 合并 会 更 困难 。 在 特定 情况 下 ， 变 基 是 合并 之 外 的 另 一 个 先 


择 。 


图 4-24 展 示 用 户 incredible 采 用 合并 和 变 基 两 种 不 同 解 决 方案 的 操作 结果 。 图 中 右上 是 合并 操 
作 后 的 结果 ， 右 下 是 变 基 操 作 后 的 结果 。 


Got Github 











pE ca 
和 一 一 性 
z I -— E C 
incredible 
merge 
9 $9 e o 8 
Ca L| 
rebase 
4a 5 gE - 
c e 


图 4-24 : 合并 和 变 基 结果 比较 
若 用 户 incredible 选择 变 基 操作 ， 执 行 命令 如 下 : 


o 获取 远程 版 本 库 的 提交 到 本 地 的 远程 分 支 。 


incredible$ git fetch origin 


e 执行 变 基 操作 ， 将 本 地 master 分 支 的 提交 变 基 到 新 的 远程 分 支 中 。 


incredible$ git rebase origin/master 


de IR aA] SRAEURGESESDIJEXRRE o 


incredible$ git push 


推送 后 的 版 本 库 状 态 如 图 4-25 所 示 。 
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4.2. 共享 版 本 库 /9 


图 4-25 : 变 基 后 推送 


如 果 布 望 在 执行 git pull 时 自动 使 用 git rebase 取 代 默 认 的 git merge 操 作 ， 可 以 在 git pull 4-43 
添加 参数 --rebase 如 下 : 


$ git pull --rebase 


或 者 通过 配置 变量 设置 当前 分 支 使 用 变 基 策略 ， 即 每 次 执行 git pull 命 令 时 对 于 master 分 支 ， 
采用 变 基 操作 取代 默认 的 合并 操作 。 


$ git config branch.master.rebase true 


如 果 布 望 本 地 所 有 克隆 版 本 库 在 执行 git pull 时 都 改变 默认 行为 ， 将 变 基 作为 首选 ， 则 如 下 设置 


全 局 变量 。 


$ git config --global branch.autosetuprebase true 


4.3. 组 织 和 团队 


GitHub 在 早期 没有 专门 为 组 织 提 供 账 号 ， 很 多 企业 用 户 或 大 型 开源 组 织 只 好 使 用 普通 用 户 账 
号 作为 组 织 的 共享 账号 来 使 用 。 后 来 ，GitHub 推 出 了 组 织 这 一 新 的 账号 管理 模式 ， 满 足 大 型 
开发 团队 的 需要 。 


e 组 织 账号 是 不 能 用 来 登录 的 ， 它 包含 一 个 Owner (拥有 者 ) 用 户 组 ， 只 有 属于 这 个 组 的 
eps 切换 为 组 织 的 管理 者 。 

e 可 以 创建 任意 多 的 团队 (Team) 即 角 色 ， 对 属于 组 织 的 用 户 进 行 管理 。Owner Teams 
是 组 织 中 权限 最 高 的 角色 。 

e 组 织 和 用 户 一 样 可 以 创建 项 目 ， 但 是 组 织 没 有 SSH 公 铀 配置 ， 也 不 能 以 组 织 的 身份 操作 
版 本 库 。 

e 组 织 没 有 工作 描述 之 类 的 个 人 账号 才 拥 有 的 属性 


4.3.1. 创建 新 组 织 


得 织 是 非 登 录 帐号， 不 能 像 创建 普通 登录 账号 那样 直接 创建 ， 而 是 需要 以 GitHub 用 户 身 份 登 
录 ， 然 后 再 创建 自己 的 组 织 ， 创 建 者 成 为 组 织 天 然 的 管理 者 。 


图 4-26 就 是 用 户 gotgithub 登 录 后 ， 通 过 点 击 右 上 朋 的 账号 设置 图 标 进 入 账号 设置 界面 ， 然 后 
再 点 击 菜单 中 的 “Organizations" 进 入 组 织 管 理 界 面 。 
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图 4-26 : 账号 设置 中 的 组 织 管理 


在 初始 的 组 织 管理 界面 中 组 织 列表 为 空 ， 即 尚 不 属于 任何 组 织 。 可 以 选择 把 当前 用 户 
gotgithub 的 账号 转换 为 一 个 组 织 账 号 《前 提 是 gotgithub 的 账号 不 属于 任何 组 织 ) 。 提 供 这 一 
账号 迁移 功能 是 因为 在 GitHub 提 供 组 织 这 一 新 功能 之 前 ， 很 多 公司 或 团队 以 个 人 身份 创建 
GitHub 账 号 ， 但 是 以 组 织 的 形象 出 现 ， 对 于 这 类 账号 ，GitHub 提 供 了 由 个 人 账号 向 组 织 账号 
迁移 的 途径 。 


Got Github 


在 这 里 我 们 不 进行 这 一 


迁移 ， 而 是 以 用 户 gotgithub 的 身份 


New Organization” 按 钮 ， 显 示 创 建 组织 表 单 ， 如 图 4-27 所 示 。 
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图 4-27 : 创建 新 组 织 


这 里 填写 组 织 名 为 GotGitOrg » 8 82 
版 本 库 的 开源 方案 。 


接 下 来 为 新 建 组 织 设 定 拥 有 者 (Owner) 


a. 


Invite your team members 


x" Signup er a personal account w^ Sep me organization 


Add Owners to the GotGitOrg organization 


PW osonnue 
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Pm done here, continue to the organization dashboard 


4.3. 组 织 和 团队 


还 要 选择 一 个 付费 方案 


Invite your beam members 


Organizations have their own billing 

The credit card and plan you choose on this screen will be bilad ta 
tha organization = not your user account (gotglithub). Receipts will 
be sent to the email you enter for thea organization 


Organizations are managed by owners 

On tha next screen you ll be able tà grant adrmminestraiive access to 
other GitHub users. Thase people will be able to manage every 
aspect of the arganizatian (billing, repassories, Tears, atc) 


What you're getting with an organization 
z Manage organization repositories in a shared location 


. Fine-grained permissions for your team 


; An organization-focused dashboard for each team member 


' 如 图 4-28 所 示 。 当 前 用 户 ， 即 正在 创建 组 织 的 用 
户 ， 理 所 当然 成 为 组 织 拥 有 者 之 一 。 还 可 以 为 组 织 指派 更 多 的 组 织 拥有 者 ， 


Irvite your taam members 


The Owners team has special privileges 

Arnone you add to this beam will bx able to modify the 
organization's billing information and will have complete access 
to alil repositories and organization information 


Each owner i5 equal in administrative capabilities 


Organizations manage permissions with Teams 


in ackdition to the Owners team, you'll ba able tà create unlimited 
teams with line-grained permissions to your nepositories. 


Add organization repositories from the dashboard 
Ahar YoU we set up your Cwners team, you ll be sani io yaur 
arganization dashboard. This is where you'll be abe to add new 
repoaitories to yaur arganization and manamga who has access to 
which reposstories. 


创建 一 个 新 的 组 织 。 点 击 “Create 


， 默认 会 选择 免费 的 没有 私有 


多 个 组 织 拥 有 者 
都 可 以 管理 组 织 ， 甚 至 可 以 将 其 他 用 户 从 拥有 者 团队 中 删除 。 
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图 4-28 : 指派 组 织 拥有 者 


完成 创建 后 ， 访 问 用 户 账号 设置 界面 中 的 组 织 面板 ， 如 图 4-29 所 示 ， 列 出 当前 用 户 所 属 的 组 
—^— P AERIS n 
个 以 上 的 组 织 ， 所 以 右 侧 将 当前 用 户 转换 为 组 织 的 按钮 被 置 灰 


Your Organizations 
Accourd Ch inny MotHie mticn Carini Piana & Billing Fi uri Hoc bo Organizations 
GotGitOrg Jmm] Dame f5 Organizations provide a simple way 


|] 
— o to manage teams of developers 
"I Simplity permissions with Teams 
w' Create a public organization profile 
+i Keep tabs on activity within your organization 


IJ 


Create mw organization 


E 4-29 : 加 入 组 织 后 的 组 织 管 理 界 面 


4.3.2. 组 织 管理 


当 用 户 gotgithub 成 为 新 建 组织 GotGitOrg 的 一 员 后 ， 就 可 以 在 用 户 和 组 织 的 界面 之 问 切 换 。 点 
击 页 面 左 上 角 *“github" 文 字 图 标 进 入 仪表 板 界 面 。 


pren om men oe Bem wx 
a 


News Feed Tour Actions Full Reguesta IR LER 


图 4-30 : 用 户 仪 表 板 界面 


仪表 板 页 面 左 上 有 角 “github” 文 字 图 标的 下 面 就 是 用 户 上 下 文 列表 框 。 点 击 用 户 上 下 文 下 拉 列 
表 ， 如 图 4-31 所 示 。 


w gotgithub E 


Switch account context 
four 


v FI] gotaithub 


^" GotGitOrg 0 repositories f 





Manage Organizations 


图 4-31 : 用 户 上 下 文 切 换 列 表 


在 用 户 上 下 文 列表 中 选择 组 织 GotGitOrg 作 为 用 户 上 下 文 后 ， 则 仪表 板 中 显示 的 菜单 和 个 人 账 
号 仪表 板 菜单 略 有 不 同 ， 如 图 4-32 所 示 。 


github Explore Gist Blog Help F ngm 党 X B 


Ej ary gj D nent 


^ GotGitOng - 


News Feed Pull Fedcuesiá lius 





Repositories (0 





f T You're an owner of the GotGitOrg organization! 
E : : 
x Hara're soma quick lips l'or an organization owner 

Create n repoafipey Tor GotGiltOrg or learn mone about 
GE ard GIEH uh 

Use the switch coniaxt bution in fhe upper laft comar ol Pig screen io 

switch batwean your personal context (gotgifub)] and this a deftunkt = 

organization 

Create mama to control access lo your ceganizabian's reposnornies, 

mean add usen qo hem. There's no bmi ao create as many as you need 


图 4-32 : 组 织 GotGitOrg 的 仪表 板 界 面 

组 织 的 仪表 板 界面 与 用 户 仪 表 板 的 不 同 之 处 在 于 增加 了 团队 管理 (Team) 和 组 织 管理 
(Organization Settings) 。 选 择 菜 单 中 的 “Team” 进 入 团队 管理 界面 ， 可 以 在 组 织 中 添加 任意 

数量 的 团队 。 添 加 新 团队 的 界面 如 图 4-33 所 示 。 


sn GotGitOrg 
Mega Feed Pul! Reciumsts EERTE] Teama Oranrirntion Settings 
Mari This team grants 
i 5- Team Chirie à permissian Save Team 
Pull Cei 
FE Push § Full 
Push, Pull & Adeministratioee 
Members Repositories 
e supergiri à; 
Add 
B omnira 
Add 
Saws Team 


E 4-33 : 添加 新 团队 iOS-Team 
创建 一 个 团队 需要 提供 四 个 选项 (如 图 4-33) 


.团队 名 称 。 如 :iOS-Team 。 
2. AKAB ° 4 : Supergirl 和 omnidroid 两 个 用 户 作 为 团队 成 员 。 
3， 团 队 权 限 。 有 三 个 选择 : 只 读 (Pull Only) 、 读 写 (Push & Pull) 、 读 写 并 管理 (Push,， 


Pull & Administrative ) 。 
4. 授权 版 本 库 。 可 以 添加 一 个 或 多 个 版 本 库 ， 只 有 对 授权 的 版 本 库 才 拥有 指定 权限 。 


其 中 团队 授权 中 的 只 读 授 权 对 于 免费 组 织 账 号 创建 的 开源 项 目 没 有 实际 意义 ， 因 为 开源 项 目 
es 的 组 织 账 号 创建 的 私 丛 版 本 库 才 体现 出 价值 。 关 于 付费 账号 和 私 窖 
版 本 库 将 在 后 面 的 章节 介绍 。 接 下 来 介绍 如 何在 组 织 账 号 下 创建 版 本 库 。 


4.3.3. 版 本 库 管 开 


组 织 拥有 独立 的 项 目 托管 空间 ， 点 击 页 面 左 上 角 的 “github” 文 字 图 标 进入 组 织 账号 的 仪表 板 界 
面 。 刚 刚 建立 的 i RR ROUES ACA | 建 ， 点 击 图 4-32 所 示 的 “New Repository" 按 钮 ， 创 建 
版 本 库 PREA) 。 


新 建 版 本 库 的 界面 如 图 4-34 所 示 。 
Create a New Repository for GotGitOrg 


Project Name Mate 
MI Fax 
If you intend to push a copy ol a repository that ia 


Description (opona) already hosted on GiHub, please lom A instead. 
i Er E LAN | 


Homepage URL (optional 


Who has access to this repository? (You can change this Later) 


(9 Anyone (learn more about public repos) 









图 4-34 : 新 建 项 目 界 面 


在 组 织 的 托管 空间 创建 项 目 与 在 普通 用 户 的 空间 下 创建 稍 有 不 同 ， 增 加 了 团队 设置 下 拉 框 。 
K] 4-34 È 7 z 4 | DE ME ? 只 能 为 项 目 指 派 一 个 已 定义 团队 ， 要 想 为 项 目 指派 更 
多 团队 可 以 在 项 目 创建 完毕 通过 项 目 管理 界面 添加 。 


下 面 来 看 一 看 如 何 为 已 建立 项 目 指派 更 多 的 团队 。 进 入 项 目 管理 页 面 ， 点 击 左 侧 菜 
项 Team”" 显 示 项 目的 团队 管理 界面 ， 可 以 通 过 该 界面 ， 为 项 目 添加 和 移 除 团队 ， 如 图 4.35 所 
iW e 


ə GotGitOrg / MyiPad 


This "epository s defmili branch is empty! + Back io Source c1 41 
MylFad = Repository Administraton 
ia Uag Ew mi pasar 5 Ned i 
Options Teams 
nti GotGROrg 
EVERYLENE WITH MCGESS 
Teams Ai Ginori 
m gatgithub 
Gere Hooks - ics. Team n inc redibis 
8 omnicirokd 
Depiy Keys 4 Chooie a Tear Add 
Andid- Team Ls supergi 
ii- Tiir 


K 4-35 : 项 目的 团队 管理 


属于 团队 的 项 目 (版 本 库 ) 可 以 转移 给 个 人 ， 反 之 亦 然 。 图 4-36 展 示 了 如 何 通过 项 目 管 理 界 
面 在 用 户 和 组 织 之 间 转 移 项 目 ORARE) 


ə GotGitOrg / MyiPad 


Thia raposlnry^s de nuh bÓmnch ia empty! + Gank to Souris c1 651 


MylPad = RHepaanary Administration 


Options Settings 


Jarice PookE Transler Ownership 
Taneler thie po tc an erganizalion whare vou have admin rights. 












































Deploy Keys —— 


| goglthub = | iz Eh 


To iranehar this mpo io another usar, plgass contaci support 





Delete this repositary 
Delte this repair 
Once wou delete a repository, There la mo gang back. Please be certain mme 





E 4-36 : 项 目 转移 


4.3.4. 个 人 还 是 组 织 


若 使 用 “Fork + Pu 的 工作 模式 ， 通 过 个 人 账号 还 是 组 织 账号 托管 版 本 库 ， 几 乎 没有 什么 差 


别 。 如 果 一 定 要 找 出 点 不 同 ， 那 就 是 在 向 托管 版 本 库 提 交 Pull Request 时 ， 邮 件 通知 的 用 户 范 
围 有 所 不 同 。 


e 对 于 个 人 账号 ， 对 其 托管 空间 内 的 版 本 库 发 出 Pull Request， 通 知 邮件 会 发 送 给 该 个 人 账 
号 及 该 版 本 库 设 置 的 所 有 协作 者 (如 果 有 的 话 ) 的 邮箱 。 

e 对 于 组 织 ， 对 其 托管 空间 内 的 版 本 库 发 出 Pull Request， 不 会 向 组 织 的 邮箱 发 送 Pull 
Request， 也 不 会 向 组 织 的 所 有 者 (Owner 团 队 ) 发 送 通知 邮件 ， 而 是 向 在 版 本 库 中 拥有 
Push 权 限 的 团队 ( 非 Owner 团 队 ) 成 员 发 送 通知 邮件 。 


因此 ， 如 果 在 组 织 的 托管 空间 创建 版 本 库 ， 一 定 要 要 为 版 本 库 指派 一 个 拥有 Push 权 限 的 
队 ， 以 免 以 “Fork + Pull€ X-r1E u} > Pull Request 没 有 人 响应 。 


若是 以 共享 版 本 库 方 式 ( 即 集中 式 协同 模式 ) 工作 的 话 ， 使 用 组 织 来 托管 版 本 库 会 比 使 用 个 
人 账号 托管 有 效 举 得 乡 。 


e 以 个 人 账号 托管 ， 需 要 逐一 为 版 本 库 设置 协作 者 (Collaborators) ， 如 果 版 本 库 较 多 且 
TUUS FP] » BOE EKA UU e 

e 以 组 织 方 式 托管 ， 将 用 户 分 组 ， 划 分 为 一 个 一 个 的 团队 〈Team) ， 以 团队 为 单位 授权 则 
方便 得 多 。 

e 如 果 是 以 付费 账号 创建 的 私密 版 本 库 ， 使 用 组 织 方式 管理 ， 会 有 包括 只 读 、 读 写 等 更 丰 
富 的 授权 类 型 ， 更 符合 项 目 管理 的 实际 。 


4.4. 代码 评注 
针对 项 目的 每 一 次 Pull Request 就 相当 于 一 次 代码 评审 ， 评 审 以 讨论 的 形式 显示 在 Pull 
Request 中 。 


在 Pull Request 中 还 能 够 看 到 对 应 的 提交 (一 个 或 多 个 ) ， 并 可 以 直接 针对 提交 进行 代码 评 
注 。 对 于 采用 集中 式 协 同 的 项 目 ， 即 使 较 少 使 用 Pull Request， 也 同样 可 以 使 用 代码 评注 。 
代码 评注 会 触发 通知 邮件 给 项 目的 开发 者 。 


代码 评注 有 两 种 形式 ， 一 种 是 针对 整个 提交 的 评注 ， 另 外 一 种 是 对 代码 进行 逐 行 评注 。 


4.4.1. 提交 评注 


查看 项 目的 提交 历史 ， 从 中 选择 一 个 提交 ， 如 图 4-37 所 示 。 


- gotgihub / helloworld 4F Admin 4» Uate ü Fork Ër Pull Reguest 4d 1 
Code Network Pull Aeguests LEITET Wik Stats Å Graphs 
Files Commis Branches 1 Taga 5» [ona hmm = 


helloworld / Commit History 


Dec 21, 2011 


Translate for Chinese. ES eiblüb)b621 
ncrnediblo j san 


: Add HEN support. FS  bbdlüilibae 


iredi Biki | 


e Merge with upstream. E) SAMPFIBEARC 


supergir 


Say hello to user if username is provided in args 
gengithuh 





Dynamic version number from git tag. Ej 6803455la"a 
3o3ithiub j 


Dec 17, 2211 


e Parse arguments using getopt long. E) 6632961522 


supergi aui 


m hella world program initial. E) ed226Aleli 


Ed I ] d 


E 4-37 : helloworld 项 目 提交 历史 
如 图 4-38 是 查看 提交 的 界面 。 除 了 提交 说 明 、 提 交 者 信息 之 外 ， 还 显示 提交 所 修改 的 文件 和 


改动 差异 。 在 查看 提交 页 面 的 最 下 方 显示 一 个 提交 评注 对 话 框 ， 可 以 在 其 中 写 下 评注 。 评 注 
可 以 使 用 Markdown 语法 。 


Got Github 


Say hello to user if username is provided in args Browse code 
Signed-off-by: Jiang Xin «gotgithub&gmeni l. com 
m gotgithub authored about 2 hours aga 1 parent &&948bia?"a commit Tb55ag9b254FBF208B72490630a25bb9a74aeeide4 
Showing 1 changed file wim 1 addition and 1 deleta. 

3; Ecc 


rU src/main,.c 


View Tia d 7E5516 


src/Á/main.c 
.. PẸ -34,7 *34,T PF void ahew veraiocaivold] 
ahow veraion([]; 
retarm Üj 


else d 






Comenia a'ü nar sed with Baie F re te MA 


下 过 下 说 起 室 档 引资 的 Bug， 霜 个 也 夫 在 过 这 个 : [一 个 空格 引用 的 亿 案 j[httpcWgit iodgiani-bug) « | 


ee 


B+ dl 3 veri the lof ol a line io make a note 


图 4-38 : 添加 提交 评注 


添加 评注 后 ， 所 评注 的 提交 的 作者 会 收 到 通知 邮件 ， 提 醒 针 对 自己 的 提交 有 了 新 的 评论 
知 邮 件 如 图 4-39 所 示 。 


Re: [helloworld] Say hello to user if username is provided in args (7b55a9b) eB 
E EHE Ox 
Mr Incredible reply*c-B15011-389825772afe1c1ae00cdd561b...(prep 16:04 (16 分 钙 前 ) i o7 
AIT OB. 
如 困 用 户 姓名 闯 有 一 个 空格 呢 ? 空格 会 把 用 户 姓 名 截断 ， 从 而 造成 输出 址 完整。 例如 : 
$ hallo jiang xin 





TEEBGÉcHBsxsfBug, BeriRET:S [—' T6985 9b XEYnttp;/giLio/gi 


Reply to this email wes or view it on GitHub: 





图 4-39 : 提交 评注 的 通知 邮件 


通过 Web 界 面 可 以 看 到 添加 在 提交 下 方 的 评注 ， 并 可 以 撰写 新 的 评注 展开 讨论 。 评 注 者 本 人 
或 提交 的 作者 还 可 以 编辑 甚至 删除 评注 。 如 图 4-40 所 示 。 


4.4. 代码 评注 89 


1 note on commit 7555a35b 
í Inerediibla cormmented ón 7555adh 28 minui 
caumnhixgd4—TeomBm?ovomBemutueRBE. mmm. sm L3 Delete 


8$ ./hallo jiamg xin 


TERREROS Aiu. SETTE TUMCOUNSOESE, 


m Write Praia Commeci aa parie with hua PF bree te Nigrikrkrem 


Tip: You can also ai] notes 19 lines in a fe. Commen an thia commit 


B+ 41 4 averte the left ol a line io make a note 





图 4-40 : 提交 评注 

GitHub 还 支持 Gt 自身 提供 的 评注 功能 [1]， 如 图 4-41 所 示 的 是 提交 http://git.io/git-notes( 即 网 址 
https://github.com/ossxp-com/gitdemo-commit-tree/commit/e80aa74) 的 评注 ， 这 个 评注 并 非 
通过 GitHub 添 加 的 ， 而 是 由 git-note 命 令 提 交 的 评注 。 这 种 评注 针对 一 个 特定 提交 只 能 有 一 
个 ，GitHub 只 能 显示 不 能 编辑 和 删除 。 关 于 如 何 通过 命令 行 查看 git-note 格 式 的 评注 ， 参 见 


《Git 权 威 指南 》 第 570 页 “41.5 Git 评 注 ”。 


&rc/^verasion.h.in 


*ÓFilfndef HELLO WORLD VERSION H 
edefine MELLO WORLD VERSION M 
i 
4AKdefine VERSION 'eversions^ 
$ 


*ilandit 


Git Notes < 





0 notes on commit e&B0aa74 (1 line note] 


@ Welbs Piriry hire Gommers ane 


pated wih i45 Fagor md NMarsdown 


54-41 : git-note7f 7x 


4.4.2. 运行 评注 


还 是 以 gotgithub/helloworld 版 本 库 中 的 提交 为 例 ， 看 一 下 GitHub 支 持 的 逐 行 评注 功能 ， 即 针 
对 提交 中 的 任意 一 行 添加 评注 。 浏 览 提 交 ， 如 图 4-42 所 示 ， 当 鼠标 置 于 任意 一 行 代码 时 ， 在 
该 行 代码 的 左 侧 会 显示 一 个 添加 注释 的 图 标 。 


Got Github 


&rc/Makefile 


main.o: vermion.h 


*werasion.h: mew header 
$ 
+a header! 
| + pej -6 "ménersion*f$$[git describe --dirty --alwayms)fg^ € vermion.h.in > version.h.tmp 
= * RLE diff -q version.h.tmp version.h »/dev/mall 2»41; then i 
* — rm wersion.h.tmp; i 
+ oplei 
+ echo "vermsion.h.in se vermsion.h"^ p & 
* gv version.h.tmp version.h; * 
+ fi 
" 


cleani 
= rm -Ë S$(TARIET] $(OBTECTS] 
+ EB -f $(TARGET] $(ONJECTS) wersilon.h 


.FHONY: all clean 


E 4-42 : Iht Edi 4n 


View Tila & £0340b1 


点 击 该 图 标 (用 于 添加 逐 行 评注 的 图 标 ) ， 会 显示 如 图 4-43 所 示 的 添加 逐 行 评 注 对 话 框 。 该 


评注 对 话 框 出 现在 两 行 代码 之 间 ， 在 其 中 写 下 评注 。 
src/Makefile 


| mnin.or versmion.h 


Cveralon.h: mew header 

$ 

*new header 

+ femi = "sj«vermioa»£fi$(git describe --dirty --always)fég^ € version.h.in * version.h.tmp 
(5 


View Tila 8€ £dd 45h 


Writa Pr Hira Comments an parsod with Gib Flareoned Markdoywn 





+t Rif diff -q vwersion.h.tmp versaicn.h »/dev/nall il; then V 
* rm wverslon.h.tmp; * 
* else 


E 4-43 : 添加 和 逐 行 评注 


添加 评注 后 ， 项 目的 开发 人 员 同 样 会 收 到 邮件 通知 。 针 对 同一 行 代码 的 多 次 评论 按时 间 顺 序 
依次 显示 ， 图 4-44 展 示 了 多 个 行 间 评注 ， 其 中 一 个 评注 还 使 用 Markdown 语法 占 入 了 一 个 图 


Ho 


4.4. 代码 评注 
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Got Github 


&rc/Makefile 国 ahowinina neces | View fille S dbidh 


main.o! Version: Hh 


^ersion.h: new header 

* 

new header: 

t Kaed -e "afxversion»fi$[git describe --dirty --always)ég" X veralon.h.in > version.h.tmp 


(3 
e supergiri LI i2 minuies ago ( 


fb git describe $H --dirty AHALE? 


上 Fw G 





dia, incredible "apo polah 


BOTH EIQDENERT 7) 





Add m lina nabr 


+ pif diff -q version.h.tmp veraion.h »/dev/null 2»&13; then 1 
* rm veraicon.h.tmp; X 
* else 和 


E 4-44 : 逐 行 评 注 和 提交 评注 


更 有 意思 的 评注 可 以 围观 MrMEEE/bumblebee 项 目的 一 个 bug 修 正 提交 (被 戏称 一 个 空格 引发 


BER) 。 地 址 : http://git.io/giant-bug( 即 网 址 
https://github.com/MrMEEE/bumblebee/commit/a04 7be85247 /55cdbeOacce6) ° 


4.4. 代码 评注 


92 


4.5. X IG JR ER 


"T (Bug Tracking) 是 软件 研发 流程 中 重要 的 一 环 ， 集 项 目 需求 管理 和 缺陷 管理 于 一 
身 ， 通 过 对 研发 工作 流 的 控制 帮助 团队 建立 规范 的 研发 体系 。GitHub 提 供 轻 量 级 的 缺陷 跟踪 
Ma ， Ad e 小 巧 、 甸 用 的 lssues 模 块 能 与 Pull Request € % %4 > XE Pull Request. 
作 流 的 有 益 补充 。 


一 个 小 型 、 管 理 文档 和 网 页 的 项 目 ， 使 用 Pull Request 往 往 就 足够 了 。 试 想 如 果 贡 献 者 能 够 和 直 
接 修改 代码 (Fork and edit this file) 并 通过 Pull Request 贡 献 给 项 目 核心 开发 者 ， 那 么 为 什么 
还 要 通过 lssues 模 块 报告 错误 并 由 他 人 来 更 改 呢 ?但 是 对 于 大 型 项 目 需 要 做 需 didi ， 或 者 参 
与 代码 开发 有 难度 ， 则 非常 有 必要 通过 |ssues 模 块 启用 缺陷 跟踪 系统 ， 提 供 更 多 途径 让 贡献 者 
参与 到 项 目 中 来 。 


缺陷 跟踪 可 以 通过 项 目的 管理 页 面 开 局 或 关闭 ， 如 图 4-45 所 示 。 
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图 4-45 : 开局 或 关闭 IlSsues 模 块 


4.5.1. 45 € 


缺陷 跟踪 系统 通常 可 用 于 管理 多 种 不 同类 型 的 问题 : 需求 、 缺 陷 或 其 它 ， 也 可 以 通过 项 目 不 
同 模块 、 组 件 来 为 问题 分 类 。GitHub 在 问题 分 类 的 实现 上 非常 简单 ， 通 过 标签 (label) 来 为 
问 题 建立 分 类 6 


开启 |ssues 模 块 后 ， 项 目的 菜单 中 多 出 一 个 “lssues” 项 ， 点 击 则 进入 问题 浏览 界面 ， 如 图 4-46 
所 示 。 左 侧 的 边栏 是 问题 过 滤器 ， 由 上 至 下 分 为 三 个 部 分 。 最 上 面 的 过 滤器 根据 问题 的 所 有 
者 对 问题 进行 算 选 ， 默 认 选 择 所 有 人 的 问题 。 中 间 的 过 滤器 是 €: e] A gt fT UR xb o 
默认 未 选 定 任何 里 程 碑 (初始 尚未 创建 任何 里 程 碑 ) ， "- 问题 进行 里 程 碑 过 滤 。 了 最 下 面 的 
过 滤器 依据 问题 标签 对 问题 进行 算 选 ， 初 始 标签 尚未 创建 。 


Got Github 
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图 4-46 : 尚未 定义 标 


Ss d Ed n dde olde 未 签 界面 。 
输入 新 的 标签 名 ， 并 为 标签 选择 一 个 颜色 ， 创 建新 的 标签， 
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图 4-47 : 创建 新 标签 


滤器 中 ， 如 图 4-48 所 示 。 过 滤器 中 的 标签 则 对 问题 进行 算 选 ， 取 消 
过 滤器 可 以 点 击 图 中 标记 的 "Clear active milestone and label filters” 链 接 。 
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图 4-48 : 过 滤器 中 的 标签 选项 


标签 过 滤器 下 方 的 “Manage Labels” 按 钮 用 于 管理 标签 ， 下 面 的 输入 框 用 于 创建 新 的 标签 。 


4.5.2. 里 程 碑 


* £5 (Milestones) 是 项 目 进度 管理 的 重要 工具 。 在 传统 项 目 管理 中 ， 里 程 碑 对 应 于 一 个 项 
目 开发 计划 、 一 个 软件 版 本 ; 在 敏捷 项 目 管 理 中 ， 里 程 碑 对 应 于 一 个 Sprint (冲刺 ) ;在 软件 
代码 的 版 本 库 中 则 对 应 于 一 个 标签 (tag) 或 分 支 (branch) » 


在 lIssues 模 块 中 的 “Milestones” 页 面 用 于 里 程 碑 管理 。 创 建新 的 里 程 碑 需 要 输入 里 程 碑 名 称 和 
里 程 碑 的 截止 时 间 ， 如 图 4-49 所 示 。 
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图 4-49 : 创建 新 里 程 碑 
创建 的 里 程 碑 以 进度 条 形式 显示 在 里 程 碑 页 面 中 ， 如 图 4-50 所 示 定 义 了 两 个 里 程 碑 。 这 两 个 


里 程 碑 的 时 间 跨 度 定 义 的 太 长 ， 敏 捷 的 项 目 管理 从 来 不 这 么 定义 。 
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图 4-50 : 里 程 碑 列表 


4.5.3. lIssue 的 生命 周期 


GitHub 的 lssues 模 块 非常 简单 ， 对 标签 和 里 程 碑 进行 简单 的 设置 后 ， CR 
块 的 配置 工作 ， 接 下 来 就 是 如 何 创 建 和 修改 |Issue， 完 成 项 目的 缺陷 跟踪 和 需求 管理 等 ， 这 才 
是 lssues 模 块 的 主要 工作 。 


每 个 Issue 都 有 自己 的 生命 周期 ， 从 问题 的 创建 ， 到 问题 的 指派 ， 再 到 问题 的 解决 ， 直 至 问题 
的 关闭 。 图 4-51 就 是 以 普通 贡献 者 身份 为 项 目 创 建 lssue。 
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图 4-51 : 以 普通 贡献 者 身份 创建 问题 


录入 问题 标题 和 描述 后 ， 点 击 “Submit new issue” 按 钮 ， 完 成 问题 创建 。 图 4-52 显 示 了 新 建立 
的 问题 ， 可 以 看 出 新 建 问题 尚未 设置 标签 。 
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图 4-52 : 新 创建 的 问题 尚未 添加 标签 等 


普通 贡献 者 创建 问题 时 只 能 录入 问题 的 标题 和 描述 ， 而 不 能 设置 问题 的 指派 ( 谁 来 负责 ) > 
添加 标签 和 设置 里 程 碑 。 如 果 希 望 问题 通知 到 特定 的 开发 者 ， 可 以 在 问题 描述 中 以 “@ 用 户 
名 "的 方式 通知 到 该 用 户 [1]， 这 也 是 众多 社交 软件 通行 的 做 法 。 


项 目 成 员 创建 问题 时 ， 拥 有 更 大 权限 ， 也 有 更 多 的 可 选项 。 如 图 4-53 所 示 。 
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A 4-53 : 以 项 目 成 员 身 份 创 建 问 题 


4.5. 缺陷 跟 踩 


Got Github 


完成 上 述 两 个 问题 的 创建 后 ， 问 题 浏览 界面 显示 新 创建 的 两 个 问题 ， 一 个 以 项 目 成 员 身 份 
建 的 问题 已 经 被 设置 了 "缺陷 ?的 标签 ， 而 另外 一 个 问题 则 没有 设置 任何 标签 。 如 ae : 
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图 4-54 : 所 有 问题 列表 


以 项 目 成 员 身 份 登录 ， 在 问题 浏览 界面 即 可 为 问题 重新 设 定 标签 ， 指 派 负 责 人 ， 设 置 里 程 
碑 ， 以 及 关闭 问题 等 。 如 图 4-55 所 示 。 
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图 4-55 : 为 问题 添加 指派 、 里 程 碑 和 标签 


在 问题 浏览 页 面 的 过 滤器 中 选择 里 程 碑 "Version 4.0“， 可 以 看 到 两 条 问题 都 显示 出 来 ， 这 是 因 
为 这 两 条 问题 都 属于 该 里 程 碑 。 里 程 碑 的 进度 条 显示 进度 为 零 ， 这 是 因为 里 程 碑 所 包含 的 全 
部 (两 个 ) 问题 都 处 于 打开 状态 ， 尚 未 解决 。 如 图 4-56 所 示 。 
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图 4-56 : i8 3d E ER jg xb Je] 

邮件 通知 功能 是 缺陷 跟踪 系统 推动 工作 流 的 重要 工具 ，GitHub 的 lssues 模 块 也 具有 邮件 通知 
功能 。 除 了 像 其 他 缺陷 跟踪 系统 在 收 到 邮件 通知 后 ， 访 问 Web 界 面 参 与 问题 的 讨论 外 ， 还 可 
以 直接 以 邮件 回复 的 功能 参与 到 工作 流 中 [2]。 

GitHub 还 支持 版 本 库 提 交 和 问题 建立 关联 ， 只 要 提交 说 明 中 出 现 '#XXx” (|Ssue 编 号 ) 字样 。 
如 果 在 提交 说 明 中 的 问题 编号 前 出 现 特定 关键 字 ， 还 可 以 关闭 问题 。 支 持 的 关键 字 有 : 


e fixes #xXxxx 
fixed xxx 


e fix Zxxx 
e closes #xxx 
e close #xxx 


closed £xxx 
下 面 就 以 gotgithub/helloworld 版 本 库 为 例 ， 关 闭 编号 为 哩 人 的 问题 。 


。 克隆 版 本 库 ， 若 本 地 工作 区 尚 不 存在 。 


$ git clone gitQgithub.com:gotgithub/helloworld.git 
$ cd helloworld 


e 编辑 文件 src/main.c， 改 正 * 问 题 #1? 发 现 的 文字 错误 。 


$ vi src/main.c 
$ git diff 
diff --git a/src/main.c b/src/main.c 
index 3daf9fe..f974b49 100644 
--- a/src/main.c 
+++ b/src/main.c 
QQ -19,7 +19,7 QQ int usage(int code) 
j say hello to the world.\n\n" 
ž hello -v, --version\n" 
" show version.\n\n" 
- B hello -h, -help\n" 
十 hello -h, --help^*n" 
à this help screen.*n*^n"), | VERSION); 
return code; 


将 修改 添加 至 暂 存 区 。 


$ git add -u 


提交 ， 并 在 提交 说 明 中 用 fixed #xxx 关 键 字 关闭 相关 问题 。 


$ git commit -m "Fixed #1: -help should be --help." 


向 GitHub 版 本 库 推 送 。 


$ git push 


推送 完毕 后 ， 在 问题 浏览 界面 可 以 看 到 里 程 碑 “Version 4.0? 的 进度 已 经 完成 了 一 半 ， 即 其 中 一 
个 问题 (H1) 已 经 完成 并 关闭 。 如 图 4-57 所 示 。 
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图 4-57 : 关闭 一 个 问题 ， 里 程 碑 完成 50% 


查看 已 经 完成 的 问题 (#1) ， 可 以 看 到 其 中 关联 到 一 个 提交 ， 该 提交 正 是 我 们 刚刚 创建 的 。 
如 图 4-58 所 示 。 
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TEMMA FRAEN: 


$ ./hello --help 


hello -h, -help 
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rm gotgithub closed the issue in b&'1215c 5 minutes ago 


图 4-58 : 已 关闭 问题 中 的 提交 链接 


点 击 关 联 的 提交 ， 显 示 如 图 4-59 的 提交 界面 ， 出 现在 提交 说 明 中 的 问题 编号 也 可 点 击 ， 指 向 
缺陷 追踪 系统 中 该 问题 的 链接 。 
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图 4-59 : 提交 中 的 问题 链接 


4.5.4. Pull Requst 也 大 Issue 


Pull Request 和 Issue 一 样 ， 也 是 一 种 对 项 目的 反馈 ， 而 且 是 更 为 主动 的 反馈 。GitHub 的 
lssues 模 块 将 Pull Request 也 纳入 到 问题 的 管理 之 中 ， 完 美 地 将 Pull Request 整 合 到 问题 追踪 
的 框架 之 中 。 


为 了 再 清二 者 之 间 的 关联 ， 首 先 创建 一 个 Pull Request » 


4.5. 缺陷 跟踪 101 


以 非 项 目 成 员 (如 用 户 omnidroid) 的 账号 访问 gotgithub/helloworld 项 目 ， 查 看 文件 
src/Makefile ， 点 击 “Fork and edit this file” 按 钮 快速 创建 派生 项 目 ， 如 图 4-60 所 示 。 
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K 4-60 : 在 线 编辑 并 创建 派生 项 目 
通过 GitHub 提 供 的 在 线 编 辑 功 能 修改 src/Makefile 文 件 ， 修 改 完毕 后 撰写 提交 说 明 ， 点 
击 “Propose File Change” 按 钮 提交 。 如 图 4-61 所 示 。 
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| Fixed #2: when new version found, update version.h and rebuild all. 
Cancel 


54-61 : 在 线 编辑 并 提交 
在 提交 说 明 中 特意 使 用 了 “Fixed #2” 关 键 字 ， 以 便 该 提交 被 上 游 版 本 库 接 纳 后 能 够 关闭 关联 的 
问题 。 


当 守 成 提交 后 ，GitHub 会 自动 开 尼 创建 新 的 Pull Request 对 话 框 ， 如 图 4-62 所 示 。 
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E 4-62 : 创建 Pull Request 


Pull Request 创 建 完毕 后 ， 除 了 在 菜单 项 “Pull Requests”" 中 有 显示 外 ， 在 “lssues” 的 问题 浏览 
页 面 中 也 会 显示 。 oe ， 新 建立 的 Pull Request 的 编号 不 是 从 宣 开 始 创建 ， 而 是 接着 
问题 的 编号 顺序 创建 ， 所 以 当 Pull Request 出 现在 问题 列表 中 时 ， 如 果 不 注意 后 面 的 山 型 的 分 
支 图 标 ， 根 本 意识 不 到 这 不 是 一 个 普通 的 问题 (Issue) ， 而 是 一 个 Pull Request - 
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图 4-63 : Pull Request 也 显示 在 lssues 中 


显示 在 问题 浏览 界面 中 的 Pull Request 和 问题 一 样 ， 可 以 为 其 设置 标签 、 指 派 负责 人 人、 设置 里 
程 碑 。 如 图 4-64 所 示 。 
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图 4-64 : 可 以 像 更 新 其 他 |lssue 那 样 更 新 Pull Request 


当 Pull Request 归 类 到 里 程 碑 “Version 4.0? 中 时 ， 在 过 滤器 打开 里 程 碑 "Version 4.0" > TRA 
到 本 来 已 经 完成 50% 的 进度 ， 由 于 新 增 了 一 个 “问题 ”(Pull Request). ， 导 致 进度 降低 了 。 如 


图 4-65 所 示 。 
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图 4-65 : 里 程 碑 进 度 调整 


点 击 编 号 为 只 3” 的 同 题 (Pull Request) ， 会 进入 到 Pull Request 页面。 点 击 页 面 中 的 “Merge 


pull request"4z 42 3: 3 Pull Request 的 合并 。 如 图 4-66 所 示 。 
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图 4-66 : 在 线 合 并 Pull Request 


A 3 "Confirm Merge” 确 认 合 并 ， 如 图 4-67 所 示 。 
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El 4-67 : 确认 合并 Pull Request 
完成 合并 后 ， 查 看 该 Pull Request， 可 以 看 到 该 Pull Request 已 经 关闭 。 如 图 4-68 所 示 。 
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f 4-68 : Pull Request E zj X M 

Ae RAER Ie Rx] 5 dn ^ 869515 $1 3,4 V 425?" Version 4.0” 的 进度 是 多 少 么 ? 

由 于 关闭 了 编号 为 #3” 的 Pull Request » 44 Pp 3E 89 Pull Request 中 对 应 提交 的 提交 说 明 的 
指令 同时 关闭 了 编号 为 唱 2" 的 问题 ， 所 以 现在 里 程 碑 “Version 4.0" 关 联 的 所 有 问题 均 已 关闭 。 
里 程 碑 也 显示 已 关闭 ， 即 里 程 碑 完 成 度 为 100% 。 


* gotgithub / helloworld 4^ Admin — €» Unwatch — i Fork — il, PulReques — €2 j? 


Code hetwor íi Pull Feguests 2 ipsias C Wiki ù Stats A Graphs 


Browse Issues Milestones g New Issue 


- € iChamr mctive milsestone nnd labe filiera re 
Everyone's lssues g 
ü open sus 7 Bubimir Lipia Ta TT 





Assigned to you ü 
Migntioning You Ü 
By B3 Fired 82: when nen version found, update version.h and rebuild all. 
y OFT cC 
— ! >. 57 MakefileX it TRE RE ig DCN n 
| rerggdag 
. HO XT: -halp 应 为 -halp OE mnm 
LABELE DEPRE 
[ SX 2 3 ed [nur irs Ti snm 


Manage Laien 























图 4-69 : 里 程 碑 关闭 


4.6. 维基 


维基 是 Web 协 同 著 作 平 台 ， 可 以 让 任何 浏览 网 页 的 人 都 能 够 方便 地 参与 网 页 的 编辑 和 创建 。 
这 源 自 于 维基 如 下 魔力 : 


快速 更 改 。 人 和 修改 网 页 无 需 复 杂 的 后 台 修 改 和 网 页 部 署 流程 ， 浏 览 的 网 页 直接 提供 编辑 按 
E 

简洁 语法 。 编 写 网 页 不 需要 学 习 复 杂 的 HTML， 取 而 代 之 的 是 易学 易 用 的 格式 化 文本 ( 维 
基 语 法 ) ， 有 的 维基 还 提供 图 形 化 编辑 界面 。 

版 本 控制 。 熟 悉 Git 的 人 ， 可 以 把 维基 看 作 是 Web 的 版 本 控制 。 历 次 修改 都 记录 在 案 ， 历 
史 修 订 可 进行 比较 ， 可 恢复 到 历史 版 本 等 。 

维基 链接 。 页 面 链接 使 用 [[ 页 面 名称 ]] 语 法 ， 可 以 非常 方便 地 创建 新 页 面 ， 并 实现 页 面 间 
的 互联 。 
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GitHub 提 供 了 维基 模块 ， 方 便 项 目 团 队 创建 社区 驱动 和 维护 的 项 目 文档 。 


4.6.1. 维基 初始 化 


GitHub 的 维基 模块 可 以 通过 项 目 管理 页 面 控制 开 ee ， 如 图 4-70 所 示 。 因为 
GitHub 提 供 了 项 目 展 示 的 多 种 途径 ， 一 些小 项 目 如 果 觉 得 用 README 文 件 构建 项 目 说 明 ， 或 
者 用 gh-pages 分 支 维护 项 目 主页 就 足够 了 ， 大 可 关闭 维基 模块 。 
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K 4-70 : 开 司 或 关闭 Wiki 模 块 


项 目 启用 维基 后 ， 进 入 维基 页 面 ， 如 图 4-71 所 示 ， 会 发 现 维基 页 面 并 没有 自动 创建 ， 还 需要 
进行 初始 化 。 
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图 4-71 : 尚未 初始 化 的 维基 界面 


点 击 “Create Wiki Now” 按 钮 ， 自 动 创建 维基 首页 ， 如 图 4-72 所 示 。 
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图 4-72 : 自动 创建 的 维基 首页 


4.6.2. 使 用 维基 


自动 创建 的 维基 首页 只 有 非常 简单 的 信息 ， 点 击 编辑 按钮 ， 修 改 维基 首页 。 编 辑 界面 如 图 4- 
73 所 示 。 
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图 4-73 : 编辑 维基 首页 


编辑 界面 有 6 个 部 分 需要 重点 说 明 : 


1. 


6. 


页 面 名 称 。 首 页 的 页 面 名称 为 Home”， 不 能 随意 更 改 ， 否 则 无 法 找到 首页 ， 或 者 页 面 之 
间 的 跳 转 会 失效 。 

工具 条 。 从 直至 右 分 别 是 设置 一 级 标题 、 二 级 标题 、 三 级 标题 、 插 入 链接 、 图 片 、 字 体 
加 粗 、 和 斜体 、 代 码 块 、 列 表 、 编 号 列表 、 引 用 、 水 平分 割 线 等 。 

页 面 语 法 格式 。 默 认 采 用 Markdown 语 法 ， 还 可 以 选用 AsciiDoc、Creole 等 语法 。 注 意 如 
果 改 变 语法 格式 ， 该 维基 页 面 的 内 容 需 要 手工 进行 调整 ， 而 且 页 面 的 实际 存储 文件 的 文 
件 扩展 名 会 改变 。 

语法 帮助 。 当 按 下 工具 条 中 的 帮助 按钮 会 显示 本 语法 帮助 表格 。 

维基 内 容 编 辑 框 。 整 个 维基 页 面 的 内 容 都 在 这 个 编辑 框 中 。 鼠 标 拖 动 该 编辑 框 右 下 角 可 
以 对 编辑 框 大 小 进行 缩放 。 

可 选 的 修改 说 明 。 修 改 页 面 时 提供 说 明 便 于 跟踪 对 页 面 的 历史 修订 。 


对 初始 创建 的 首页 进行 更 改 ， 如 图 4-74 所 示 。 


Got Github 


Editing Home ViwPage Page History 
h a h3 OG Ò B [ (1) DE & wm T EdN Mods: — Markdesven 


This is a sample project for the book "GotGitHub". 


Es HOWTOS 





E 4-74 : 修改 选中 文本 样式 

图 4-74 中 ， 在 维基 内 容 编 辑 框 中 选择 两 行文 本 ， 然 后 点 击 工 具 栏 中 的 列表 按钮 ， 为 选中 内 容 
应 用 列表 样式 。 应 用 新 样式 后 的 效果 如 图 4-75 所 示 。 然 后 填写 提交 说 明 ， 点 击 “Save” 按 钮 保 
存 更 改 。 
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This is a sample project for the book "GotGitHub", 
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* To access the repository of this project see: [[HowtoClone]] 
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图 4-75 : 填写 提交 说 明 保 存 更 改 


注意 图 4-75 的 维基 内 容 中 有 [[ 页 面 名 称 ]] 样 式 的 语法 ， 这 个 语法 是 维基 特色 的 页 面 链接 语法 ， 
指向 另外 的 维基 页 面 。 实 际 页 面 输出 如 图 4-76 所 示 。 
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This is a sample project for the book "GotGatHub". 
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图 4-76 : 保存 更 改 后 的 维基 首页 


如 果 对 维基 语法 [页面 名 称 ] 生 成 的 链接 标题 不 满意 ， 还 可 以 用 [[ 链 接 标题 | 页 面 名 称 ]] 格 式 创建 


维基 链接 。 对 首页 重新 做 一 次 修改 ， 人 和 修改 如 下 : 





e 将 [[HowtoClone]] 改 为 [[how to clone|HowtoClone]] ° 
e 将 [[HowtoContribute]] 改 为 [[how to contribute|HowtoContribute]] ° 


一 ~ 


多 改 后 的 首页 效果 如 图 4-77 所 示 。 
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图 4-77 : 修改 维基 链接 标题 后 的 首页 


无 论 怎样 更 改 维基 页 面 都 不 怕 内 容 丢 失 ， 因 为 维基 记录 了 每 一 次 修订 历史 ， 并 可 以 回 退 任意 
一 次 修改 。 点 击 维 基 页 面 中 的 “Page History” 按 钮 ， 查 看 页 面 修订 历史 ， 如 图 4-78 所 示 。 
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图 4-78 : 页 面 修 订 历 史 


首页 的 修订 历史 记录 着 维基 初始 化 以 来 所 有 的 修改 ， 和 包括 修改 者 、 修 改 时 间 、 提 交 说 明 ， 以 
及 一 个 可 点 击 的 对 象 ID。 点 击 对 象 1ID 查 看 对 应 版 本 的 页 面 。 还 可 以 对 不 同 版 本 的 页 面 进行 比 
较 ， 选 中 两 个 版 本 点 击 “Compare Revisions” 按 钮 ， 如 图 4-79 所 示 。 
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图 4-79 : 页 面 版 本 间 比 较 





在 页 面 版 本 间 的 比较 界面 中 ， 提 供 回 退 此 次 修改 的 按钮 。 点 击 “Revert Changes” 按 钮 (图 4-79 
PUR) ， 可 以 回 退 对 首页 的 修改 。 查 看 首页 的 修订 历史 ， 会 看 到 回 退 记录 也 显示 其 中 ， 如 图 4- 
80 所 示 。 
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图 4-80 : 包含 回 退 记录 的 页 面 修订 历史 


在 维基 中 创建 新 页 面 有 多 种 方法 ， 可 以 点 击 页 面 中 的 “New Page” 按 钮 ， 也 可 以 像 我 们 之 前 做 
的 那样 先 在 页 面 中 用 [[ 页 面 名 称 ]] 格 式 谋 入 维基 链接 ， 然 后 在 生成 的 页 面 中 可 以 看 到 指向 新 页 
面 的 链接 ， 当 然 这 些 链接 所 指向 的 页 面 并 不 存在 。 
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图 4-81 : 页 面 中 的 维基 链接 


如 图 4-81 所 示 ， 点 击 页 面 中 指向 不 存在 维基 页 面 的 链接 ， 会 自动 开启 创建 新 页 面 的 对 话 框 ， 
如 图 4-82 所 示 。 


Create New Page 


There are 2 git repositories for this project! One for the project itself, and one for the wiki! 


== Repository for the project itself == 

You can clone the repository using 3 different protocol: 
Ut 

$ git clone https://github.com/gotgi thub/helloworld.git 
$ git clone git://github.com/gotgithub/helloworld.git 

$ git clone git&github.com:gotgithub/helloworld.git 

}}} 


Page initial. | 
54-82 : 创建 新 维基 页 面 


输入 维基 页 面 的 内 容 ， 然 后 境 写 提交 说 明 ， 点 击 “Save” 按 钮 ， 保 存 新 页 面 。 生 成 的 新 页 面 如 
图 4-83 所 示 。 
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You can clone tha repository using 3 different protocol: 


$ git clone httpa://github.com/gotgithub/hellowoerld.qit 
$ git clone git:i//github.com/gotgithab/helloworld.git 
$ git clone gitügithub.com:gotgithub/helloworld.git 


Repository for the wiki 


Use one ot tha fallawing command. (pay attension to the wiki suffix in tha url) 


$ git clone httpa://github.com/gotgithab/halloworld.,wiki.qit 
$ git clone git:i//github.com/gotgithab/helloworld.wiki.git 
$ git clone gitügithub.com:gotgithub/helloworld.wiki.git 


图 4-83 : 生成 的 新 页 面 


如 果 当 前 用 户 对 页 面具 有 写 权 限 ， 则 在 页 面 左 下 角 会 看 到 一 个 删除 本 页 面 的 链接 。 点 
击 “Delete this page” 链 接 并 经 确认 后 会 删除 页 面 。 然 后 继续 在 维基 中 操作 ， 如 创建 另外 一 个 新 
页 面 HowtoContribute ° 


如 果 对 之 前 删除 页 面 Howtoclone 的 操作 后 悔 ， 可 以 通过 下 面 方法 找 回 。 
e. 访问 菜单 中 的 “Wiki History" 项， 显示 整个 维基 的 修订 记录 〈 不 是 东 个 页 面 的 修订 记 
录 ) 。 如 图 4-84 所 示 。 


Homa Pages Wiki History Ga Access 


History 


Compare Revisions 





m getgithum Hewtocontnibuti initial [D*37c&«] 
M^ P ongtnub | i i Destroyud Hewtoclona (creole) [D282 175] 
加 P gergithub ! Page initial. jB284374] 
rn Reven cati SbBcád116/0a0/b97008554301c2b8467c58 
poig B6 a&cb4Ba6355 1 B2ceab307/95c087b7bca64 [5bcOdfb] 
国 gorgenue Update nares of wiki baka. [0641887 
图 oononhus Add 2 sections: about and howtos. [caQ15b6] 
图 ootgitnun initial Comma [1ca26c8] 


Compare Fryisions Back tà Tog 


图 4-84 : 维基 修订 记录 


e 从 图 4-84 可 见 上 面 第 二 条 记录 就 是 删除 HowtoClone 页 面 的 操作 ， 选 择 该 记录 及 前 一 次 记 
录 ， 执 行 版 本 比较 ， 如 图 4-85 所 示 。 
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Home Pages  — Wiki History Git Access 


Compare Revisions View Page Back to Page History 


Fevert Changes 


Howtoclone.creole 


KT" 一 山大 *H.D PE 

-There are J git repositories for this project| Ons for the project itself, and ome for the wikil 
-=a Régository for the project ltaeli == 

-Youà can clone khe repository using J diffsrest protocol: 

-iti 

-$& git clone httpa://github.com/gotgithub/belleworld.git 

= git élone gik:i//lgithub.con/gotgithab/helloworld.git 

-$& git clone gitigithub.con:igotgithub/helloworld.qgit 

=}}} 

-=a Renpo&itory for the wiki == 

-Use one of the following command. [pay attension to the .wiki &uffix ia the uri) 
={{{ 

= git clone httpar//github.com/gotgithub/belloworld.wiki.git 

= 上 git clone gik:i//github.com/gotgithab/helloworld.wiki.git 

-& git clone gitihgithub.conigotgithub/helloworld.wikil.git 

=}}} 

A Wo newline at end of file 





Rarvert Changes Back 15 Top 


图 4-85 : 版 本 比较 


e 点 击 “Revert Changes” 按 钮 ， 可 以 取消 页 面 删除 动作 。 更 新 后 的 维基 修订 历史 如 图 4-86 所 
Ro 
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usi nos Meven üzed3TafTcidedasW4d$35e262aala?üded3as3 0282175059151aa42a5 74989842 dad 
[2856287] 

图 gotgithub I? minutes ago: Hewtocontribute initial. [5797064] 

P soonub i 

2 | about an hour ago: Reven cadi Sb&otd 1/6 080 /b9700655430162b8487c8e 

potpis Di e&chales3Ib18206a5307f9 5:08 Th Tebca&4 [Sbeüdfh] 

图 gotgithub about an hour apa: Update names of wiki links. [D61a6c] 

图 gotgithub about an hour ago: Add 2 sections- about and howibs. [ca015b6] 

图 gotgithub ibout 2 hours ago: Initial Commit [1682668] 
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Pages Wil History Gt Access 
D New Page 
EJ 


+ Home 
+ Howtoclonae 


s Howtocontribute 


图 4-87 : 维基 页 面 列表 


4.6.3. 维基 与 Git 


随 着 对 GitHub 维 基 的 深入 使 用 ， 可 能 会 遇 到 下 面 的 问题 : 如 何 衣 入 图 片 ? 多 人 编辑 时 如 何 避 
免 冲突 ?解决 这 几 个 问题 的 办 法 就 是 用 Git 操 作 维 基 。 在 之 前 查看 维基 修订 历史 ， 以 及 进行 版 
本 间 比 较 时 可 能 已 经 看 出 和 Git 是 如 何 的 相似 ， 实 际 上 GitHub 的 维基 页 面 就 是 用 Git 版 本 库 实 现 
的 。 


在 维基 页 面 访问 菜单 中 的 “Git Access” 项 ， 会 看 到 用 Git 访 问 维基 页 面 的 方法 。 如 图 4-88 所 示 。 


Homa Pages Wiki History Git Access 


BSH HTTP Git Read-Only ts jot gi thub hel Lorm LIT, t 4 PReadaWribe = 
Your wiki data can be cloned from a git repository lor offline access. You have several options Por editing if at this point: 


1. With your favorite text editor or IDE 
2. With the built-in web interface, included with the Golum Ruby API. 
3. With the Collum Fuby AFT. 


When you're done, you can simply push your chances back to Gitlub to Sec them reflected on the sibe., The wild repasaaries obey the same 
access nues asthe source raepossorny that thay belong tà 


图 4-88 : 用 Git 访 问 维 基 
对 于 项 目 gotgithub/helloworld 来 说 ， 用 Git 克 隆 其 维基 ， 用 如 下 命令 : 


$ git clone gitQgithub.com:gotgithub/helloworld.wiki.git 


进入 到 刚刚 克隆 的 helloworld.wiki 工 作 区 中 ， 查 看 包含 的 文件 ， 会 看 到 有 三 个 文件 。 


$ cd helloworld.wiki 
$ ls 
Home.md Howtoclone.creole Howtocontribute.md 


三 个 文件 对 应 于 三 个 维基 页 面 ， 文 件 名 就 是 维基 的 页 面 名 称 ， 而 扩展 名 对 应 于 采用 的 维基 语 
法 。 以 .md 扩展 名 结尾 的 页 面 采用 Markdown 语 法 ， 而 以 .creole 结 尾 的 文件 采用 Creole 标 准 维 
基 语 法 。 


下 面 就 通过 Git 在 维基 版 本 库 中 添加 一 个 图 片 。 添 加 图 片 的 操作 只 通过 GitHub 维 基 的 Web 界 面 
是 很 难 实现 的 ， 而 使 用 Git 则 多 如 反 掌 。 


e 创建 一 个 名 为 images 目 录 。 这 个 目录 并 非 必 须 ， 只 是 为 了 易于 管理 。 


$ mkdir Images 
$ cd images 


e 在 images 目 录 中 添加 图 片 。 
下 面 的 操作 从 GitHub 官 方 版 本 库 中 下 载 图 片 octocat.png 并 进行 适当 缩放 。 


$ wget https://github.com/github/media/raw/master/octocats/octocat.png 
$ mogrify -resize '200' octocat.png 


e 将 图 片 添加 到 暂 存 区 并 提交 。 


$ git add octocat .png 
$ git commit -m "add sample image." 


e 将 本 地 提交 推送 到 GitHub 远 程 版 本 库 。 


$ git push 


完成 推送 后 ， 访 问 下 面 的 网 址 可 以 看 到 刚刚 上 传 的 图 片 : 
https://github.com/gotgithub/helloworld/wiki/images/octocat.png 


TREA nPI ERA KAA A 89 Markdownis kA : 。 当 然 可 以 通过 
编辑 本 地 版 本 库 gotgithub/helloworld.wiki.git 中 的 文件 ， 但 通过 GitHub 维 基 编 辑 界 面 襄 入 图 片 
无 需 记 忆 复 杂 的 语法 。 如 图 4-89 所 示 。 
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14-89 : 在 维基 页 面 中 髓 入 图 片 


点 击 “Preview” 按 钮 ， 可 以 在 保存 前 查看 效果 。 在 图 4-90 所 示 的 预览 界面 中 可 以 看 到 修改 后 的 
效果 。 


Home (Preview) 


This is a sample project for the book "GotGitHub". 





HOWTOs 
+ To access the repository of this project see: HowtoClone 
+ For contributers, see: HowtoContribute 
图 4-90 : 预览 效果 


多 人 同时 编辑 一 个 维基 页 面 会 引起 冲突 ， 先 提交 的 用 户 会 成 功 ， 其 他 用 户 的 编辑 界面 马上 会 
显示 冲突 敬告， 并 且 保 存 按钮 也 被 置 灰 ， 如 图 4-91 所 示 。 


-diting Home sexe] [atum 





This is a sample project for the book "GotGitHub". 


I [GitHub üctacat](https://github.com/gotgi thub/helloworld/wiki /images/octocat .png) 


EB HÜNTUS 
* To access the repository of this project see: [[HowtoClone]] 
* For contributers, see: [[HowtoContribute | | 


Use absolute URL, à image link broken when access wiki hore using helleword/wiki, not hallewornd/wiki [with a slash at then end) 


Cannmat Sane, Gone Else Has Edited | 





图 4-91 : 编辑 冲突 
GitHub 的 维基 编辑 界面 没有 提供 冲突 解决 的 工具 ， 而 利用 Git 本 身 强 大 的 冲突 解决 功能 可 以 很 
容易 地 解决 这 一 难题 。 


例如 用 户 gotgithub 编 辑 维 基 首 页 Home 遇 到 编辑 冲突 ， 为 防止 数据 丢失 ， 先 将 编辑 框 中 的 维基 
文本 拷贝 并 粘贴 到 一 个 临时 文件 中 ， 如 文件 中 /path/to/draft.md。 然后 进行 如 下 操作 将 
draft.md 中 内 容 合并 到 维基 页 面 中 。 


e 如 果 本 地 已 经 克隆 维基 版 本 库 ， 则 执行 下 面 命令 更 新 。 


$ cd helloworld.wiki 
$ git pull 


e 如 果 没 有 ， 则 克隆 维基 版 本 库 。 


$ git clone gitQgithub.com:gotgithub/helloworld.wiki.git 
$ cd helloworld.wiki 


e 用 Git 命 令 查 看 版 本 库 的 历史 ， 以 便 找 出 发 生 冲 突 的 原始 版 本 。 


从 下 面 的 输出 可 以 看 出 我 们 编辑 的 版 本 是 基于 提交 fbb4bb4， 由 于 用 户 incredible 先 于 我 们 
完成 了 对 维基 页 面 的 修改 以 致 发 生 了 冲突 。 


$ git log -3 --pretty-short 
commit 5ff5d998bb6cf99337813915282df94701d17ea0 
Author: incredible 
Add a note as image link broken if url without a end slash. 


commit fbbaAbbaf330bacf765d51736359b90a3e81ed945b 
Author: gotgithub 


Insert image in page. 


commit 94182c2b57ebceidfibf8a310f78df87ae8e8219a 
Author: gotgithub 


add sample image. 


基于 提交 fbb4bb4 建 立 分 支 ， 如 分 支 mywiki。 
$ git checkout -b mywiki fbb4bb4 


e 将 保存 的 draft.md 履 盖 谷 修改 的 文件 ， 如 Home.md。 


$ cp /path/to/draft.md Home .md 


$ git add -u 
$ git commit -m "Use absolute image link." 


e 切换 到 master 分 支 。 


$ git checkout master 


合并 我 们 在 mywiki 分 支 的 修改 。 


$ git merge mywiki 

Auto-merging Home.md 

CONFLICT (content): Merge conflict in Home.md 

Automatic merge failed; fix conflicts and then commit the result. 


e 调用 图 形 工 具 解 决 冲 突 。 


$ git mergetool 


e 提交 并 查看 合并 后 的 提交 关系 图 。 


$ git commit -m "merge with incredible's edit." 

$ git log --oneline --graph -4 

i d33b55a merge with incredible's edit. 

D 

| * 121c3b2 Use absolute image link. 

* | bff5d99 Add a note as image link broken if url without a end slash. 
|/ 

* fbb4bb4 Insert image in page. 


e 查看 用 户 incredible 的 修改 。 


$ git show --oneline HEAD^1 
5ff5d99 Add a note as image link broken if url without a end slash. 
diff --git a/Home.md b/Home.md 
index 6ada8e8..0bca3ec 100644 
--- a/Home.md 
+++ b/Home.md 
QQ zi 5 *1,/ QQ 
This is a sample project for the book "GotGitHub". 


+**Note**: if can not see the following image, add a slash('/') at the end of the URL. 
十 


! [GitHub Octocat](images/octocat.png) 


## HOWTOS 


e 查看 用 户 gotgithub 的 修改 。 


$ git show --oneline HEAD^2 

121c3b2 Use absolute image link. 

diff --git a/Home.md b/Home.md 

index 6ada8e8..cdb9167 100644 

--- a/Home.md 

+++ b/Home.md 

QQ -1,6 *1,6 QQ 

This is a sample project for the book "GotGitHub". 


-! [GitHub Octocat](images/octocat.png) 
+! [GitHub Octocat](https://github.com/gotgithub/helloworld/wiki/images/octocat.png) 


## HOWTOS 
* To access the repository of this project see: [[HowtoClone]] 


e 将 本 地 合并 后 的 版 本 库 推送 到 GitHub 。 


$ git push 


再 来 看 看 推送 后 GitHub 的 维基 修订 历史 ， 和 本 地 版 本 库 看 到 的 历史 是 一 致 的 ， 如 图 4-92 所 
o 
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图 4-92 : 推送 后 


papo marge wiih incnedible's edit. kamosa] 
155. Use absolute image lini [1210352] 
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"agi add sample image. [G41&2c2] 


bout : jò RemwenrB2ged3Ta7TcTdedaest1535e202aafa T G4ed eC) .. 
02921 TbccO!t6laad4.2a57490322169a158bd1040d [2850267] 


t3 hours ago: Hawtocontribule initial. [b78 cfe] 
jo: Destroyed Howtociona (mecs) [X282 175] 
;^ Page initial. [Bze4378] 


PE ago Aeran cati iniedi Wa rele .- 
ü6'te6cb4Be63I1B2cenb30795c087b7abca64 [menidi] 


; Update names af wiki briks [961166] 
jc- Add 2 sectons: about and howtos. jcan15b6] 


- 536 Initial Commit [1c826c8] 


Back 15 Top 


的 维基 修订 历史 


GitHub 维 基 背 后 的 引擎 名 为 Gollum，GitHub 已 将 其 开源 ， 项 目 网 
址 : https://github.com/github/gollum 。 安 装 Gollum， 在 克隆 的 维基 版 本 库 中 运行 gollum 就 可 
以 在 本 地 局 动 维基 服务 。 


4.6. 维基 


122 


5. 付 炙 服务 


GitHub 神 奇 的 协同 工具 使 得 开源 项 目的 创建 和 协同 更 加 简单 、 高 效 。 有 些 人 可 能 会 提出 疑 
Hl: 能 否 把 GitHub 用 于 私有 项 目 呢 ? 即 能 否 只 允许 指定 的 用 户 访问 项 目 和 版 本 库 ， 而 其 他 人 
不 能 访问 呢 ? 能 否 在 企业 内 部 架设 一 个 一 模 一 样 的 GitHub 服 务 呢 ?GitHub 针对 这 些 需 求 提供 
了 解决 方案 ， 这 些 解决 方案 需要 或 多 或 少 地 付出 一 定 费 用 。 


Got Github 


5.1. GitHub/X È 7 Z 


访问 网 址 https://github.com/plans 可 以 看 到 GitHub 提 供 的 不 同 的 服务 方案 列表 。 


Plans & Pricin 


Join today and coltaborate g inae emartest developers in Tha world 


Creabe à free account 


E Free for open source 


Unlimited pubic repositones and undimitd public collaboratars 


Micro ST Small $12: Medium $22 mo 
5 Private Repositories 10 Private Repositories 20 Private Repositories 
1 Private Colaborator 5 Private Collaborators 10 Private Collaborators 

Unlimited public repasibonues Unlimited public nencsitones Unlimited public repasitonies 


Unlimited public collaborators Unlimiled mit colanmcrators Unlimited public collaborators 








Crosie an eccumi 


a LCTIDETE TM 


ITI i 





Business Plans 


Bronze $25. Silver S50 Gold 5100... Platinum 5200... 


10 Private Repositories 20 Private Repositories 50 Private Repositories 125 Private Repositories 
Unlimited Teams Unlimited Teams Unlimited Teams Unlimited Teams 
Unlimited public repasitones Unlimited public repasitories Unlimited pubs repasitories Unlimited public reposstories 


Create an organization Croate an organizalion Create an organiralion Create an organérailion 
| 





图 5-1 : GitHub 服 务 方案 列表 
图 5-1 中 显示 了 GitHub 的 三 类 (8 种 ) 服务 方案 : 


e 第 一 类 是 免费 方案 。 免 费用 户 账 号 可 以 创建 任意 数量 的 开放 式 项 目 (版 本 库 ) ， 并 且 可 
以 为 开放 式 项 目 设置 任意 数量 的 协同 者 。 

e 第 二 类 是 需要 付费 的 个 人 账号 方案 。 付 费 的 个 人 账号 允许 托管 私有 版 本 库 ， 即 可 以 创建 
只 有 自己 及 指定 的 私有 协同 者 才能 够 访问 的 版 本 库 ， 而 其 他 人 不 能 访问 。 根 据 允许 创建 
的 私有 版 本 库 数量 及 私有 版 本 库 协 同 者 数量 ， 提 供 了 三 种 收费 标准 (7 美元 /月 、12 美 元 / 
月 和 22 美元 /月 ) 。 

e 第 三 类 是 需要 付费 的 组 织 账号 方案 。 使 用 付费 的 组 织 账号 ， 可 以 突破 私有 项 目的 协同 者 
数量 限制 ， 并 使 用 更 易 管 理 的 团队 (Team) 对 项 目 进行 授权 。 关 于 如 何 通过 团队 配置 授 
Tus 1.4.3. 组 织 和 团队 ”。 组 织 账号 的 付费 标准 较 个 人 账号 更 高 (有 25 美 元 /月 、50 美 元 / 
月 、100 美 元 /月 和 200 美 元 /月 ) ， 但 同时 也 可 以 创建 更 多 的 私有 版 本 库 和 拥有 更 大 的 托 


用 户 可 以 随时 升级 或 降级 自己 在 GitHub 上 的 服务 方案 。 点 击 菜单 中 的 "Account Settings” 可 以 
看 到 当前 所 选 方案 ， 如 图 5-2 所 示 。 


5.1. GitHub 收 费 方 案 124 


Account (rari Motification Carter Piana & Billing Fe posit oria Organizations 


Free 0/0 0/0 0.00G8/0.30GB 
C n Á | 


图 5-2 : 用 户 所 选 方案 及 状态 


点 击 图 5-2 中 的 “Change plan" 按 钮 ， 进 入 到 更 换 GitHub 服 务 方 委 页 面 ， 如 图 5-3 所 示 。 


Account Settings 
Account Cviervare Hotifizatkonm Cirit Plana & Billing Fiir pucri Hcet a à Organiration 
Free 0/0 mo D. 00GBAD, 30GB 
ia Ni 
Change your plan ES No credit card on file. 
Payment Histony Pha ü Pinos orae Ü Colixvakes Dii Space [so limi 
Medium ($22/month) 20 10 240GB 
Small ($12/month) 10 5 1.20GB Upgrade 
Micro ($7/month) 5 1 0.60GB Upgrade 
Free ($ü/month) 0 ü 0.30GB 
Larger plana available on request — contact supports gibub eom 
Have a coupon ode? Enter it here, 
. Need group management? Try organizations. 
图 5-3 : 更 换 方 案 
选择 适合 的 收视 方案 并 付款 后 ， 即 可 完成 服务 方案 的 升级 。 
当 inp 用 户 升 级 为 付费 账号 后 ， 创 建新 版 本 库 时 就 可 以 通过 新 的 选项 创建 私有 版 本 库 


。 即 在 创建 版 本 库 时 ， 如 果 不 选 bie de ' 而 是 选择 “Only the people | specify" "T 
" 建 私 有 版 本 库 ， 如 图 5-4 所 示 。 


Got Github 


Create a New Repository 


Project Name 


Note 
GatiitHubDratt 


If you intend to push a copy ol a reposilory thal is 
" riptian (plional) already hosted on GitHub, please lesk it matead. 
Draft for the book GotüitHub 


Homepage URL tootionall 


Who has access to this repository? (You can change this later) 


Anyone (learn more about public repos) 





图 5-4 : 创建 私有 版 本 库 
通过 版 本 库 的 管理 界面 ， 可 以 随时 将 版 本 库 的 状态 在 公开 和 私有 之 间 切 换 ， 如 图 5-5 所 示 。 


& gotgithub / GotGitHubDraft 


+ Back ta Seures 31 71 


QGotültHubDratft = Repossony A&drminesmanon 


Options Settings 
Collaborators Fispostiory Name 
(GotiatHubDeaft Rename 
Service Hooks - - 
De Essi 
papon Dedmult Branch mäer I 


图 5-5 : 私有 版 本 库 管 理 界面 


付费 账号 的 公开 版 本 库 没 有 协同 者 数量 上 的 限制 ， 但 是 私有 版 本 库 却 存在 协同 者 数量 上 的 限 
制 。 如 图 5-6 所 示 ， 当 私有 版 本 库 的 协同 者 数量 超出 所 选 GitHub 付 费 方案 的 限额 后 ， 会 显 
示 “OVERLIMIT” 的 敬告， 不 过 超出 限额 的 协同 者 依然 可 以 操作 私有 版 本 库 。 


a gotgithub / GotGitHubDraft 


中 Back io Spure 4e 4 jid 


GeotGitHubDraN = Repository Adminigration 


Options 


Jandan 
LI P gxin Private collaborators are github 
Users hal have access Ip one or mone 
careia Hooks Mui 0? your private repositornas 
Deploy Keys 


图 5-6 : 添加 私有 协同 者 
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组 织 是 一 类 特殊 的 不 能 登录 的 用 户 账号 。 如 果 要 对 组 织 账 号 进行 配置 ——Ó——— 
的 用 户 账 号 登录 ， 再 通过 切换 上 下 文 的 方式 访问 组 织 账号 。 图 5-7 就 是 以 gotgithub 用 户 账 号 
录 后 ， 切 换 到 GotGitOrg 组 织 账号 的 管理 界面 。 


2 GotGitOrng 

News Feed Pull Fegusestü lá ui Teama ÜOrganizsbon Settings. 
Free 0/0 0. 00GB/0. 30GB 
E EN | 


图 5-7 : 团队 账号 的 所 选 方案 及 状态 


在 图 5-7 所 示 的 组 织 账号 管理 界面 中 显示 了 组 织 账号 当前 的 GitHub 方 案 ， 点 击 其 中 的 “Change 
plan” 按 钮 ， 显 示 如 图 5-8 所 示 界 面 ， 可 对 组 织 账号 的 GitHub 方 案 进 tH AUR o 





sa GotGROrng 
Nera Feed Pil Flies diis IL ETE! Tira Organization Settings 
Free 0/0 0.00GE/D. 30GB 
sah imi 
Change plan ——áá——— | 
Account Info No credit card on file. 
Chamari 21 Dic 
Platinum ($200/month) 125 60.00GB Upgrade 
Müarnibarrs 
Gold ($100/month) 50 20.00GB Upgrade 
Heposibories (1) 
Silver ($50/month) 20 8.00GB 
Billing 
Bronze ($25/month) 10 2.406B 
—: Frea (Sü/month) 0 0.30GB 


Larger plans available on request 一 contact support i github.com 


Have a coupon code? Enter H heres, 
图 5-8 : 团队 账号 更 换 方案 


为 组 织 账号 选择 一 个 付费 方案 后 ， 就 可 以 在 组 织 的 账号 下 创建 私有 版 本 库 ， 并 以 团队 方式 管 
理 该 私有 版 本 库 的 授权 。 ye o 
a GotGitOrg / NonPublicRepos ask Ée | o1 A 


NonPublicRepos = Repository Adrminisrabon 


Options Settings 


Repository Name 
Teams 


NonPublicPfepos 


cen Hooks 
Visibility 





Depioy Keys 
| Detiult Branch master = 


图 5-9 : 团队 的 私有 版 本 库 设 置 


5.2. GitHub 4 1L 5A 


出 于 隐私 或 法 律 原因 而 不 能 将 代码 托管 到 第 三 方 平台 的 企业 ， 可 能 希望 在 企业 内 部 架设 专 有 
的 GitHub 服 务 ， 能 做 到 么 ?答案 就 是 GitHub 企 业 版 (GitHub Enterprise) 。 


网 址 : https://enterprise.github.com/ ° 


GitHub 企 业 版 搭建 在 企业 本 地 网 络 中 ， 因 此 企业 拥有 对 版 本 库 和 项 目 完 整 的 控制 权限 。 
GitHub 企 业 版 包含 了 GitHub 上 所 有 的 好 东西 : 提交 历史 、 代 码 浏览 、 上 比较 视图 、Pul| 
Requests、 问 题 追 踪 、 维 基 、Gists、 组 织 和 团队 管理 、 强 大 的 APIl， 和 漂亮 的 界面 ， 因 此 会 
使 用 GitHub 就 会 使 用 GitHub 企 业 版 。 此 外 企业 版 还 增加 了 对 LDAP 和 和 CAS 支持 功能 ， 以 便 和 企 
业 现 有 的 认证 系统 整合 等 等 [1] 。 


GitHub 企 业 版 不 像 它 的 前 身 GitHub:FI(GitHub:Fl 是 GitHub Firewall Install 的 缩写 ， 含 义 为 在 企 
业 的 防火 墙 内 部 架设 GitHub 服 务 ， 现 已 升级 为 GitHub Enterprise。) 那 样 通过 下 载 软件 包 进 行 
安装 和 部 署 ， 而 是 提供 基于 虚拟 机 的 解决 方案 。 即 GitHub 企 业 版 以 OVF 虚 拟 机 文件 格式 发 
布 ， 可 以 运行 在 多 种 虚拟 机 平台 ， 如 : VMWare ` VirtualBox ` Oracle VM ` Red Hat 
Enterprise Virtualization 和 IBM POWER 。 使 用 OVF 格 式 让 GitHub 企 业 版 的 部 署 更 加 轻松 。 


GitHub 企 业 版 根据 用 户 数量 收取 年 费 ， 入 门 级 的 价格 为 20 用 户 每 年 5,000 美 金 。 如 果 用 户 数 
少 ， 建 议 采 用 付费 的 GitHub 托 管 账号 。 购 买 更 多 用 户 许 可 ， 访 问 GitHub 企 业 版 网 站 ， 那 儿 有 
一 个 报价 生成 器 ， 如 图 5-10 所 示 。 


Get a Price Estimate 


Team Size | 
All users who will require accounts 


Seat Packs Required 1 

Total Seats Purchased 20 
Total Yearly Cost $5,000.00 
Try it first 


You can try GitHub Enterprise free of charge 
with unlimited users for 45 days. 


Start a Free Trial 





图 5-10 : GitHub 企 业 版 报价 生成 器 


Got Github 
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6. GitHub 副 产品 


GitHub 有 最 核心 的 产品 是 Git 版 本 库 〈 即 项 目 ) 托管 ， 此 外 GitHub 还 提供 一 些 副 产品 (Side 
Project) ， 通 过 附加 的 服务 或 技术 提供 了 更 多 有 趣 的 功能 。 例 如 提供 数据 粘贴 的 Gist 网 站 ， 对 
其 他 版 本 控制 工具 如 SVN 和 Hg 的 支持 ， 各 具 特 色 的 客户 端 工具 ， 求 职 网 站 ， 销 售 纪念 品 的 
GitHub 商 店 等 等 。 


6.1. GitHub:Gist 


在 GitHub 网 站 的 导航 条 上 就 有 Gist 子 网 站 的 链接 : https:/gist.github.com/ ， 在 本 节 我 们 就 揭 
开 其 面纱 。 


github explore[ ss]aes Help FS aotoithub A X [* 


图 6-1 : GitHub 上 的 Gist 链 接 


Gist 作 为 一 个 粘贴 数据 的 工具 ， 就 像 Pastie 网 站 [1] 一 样 ， 可 以 很 容易 地 将 数据 粘贴 在 Gist 网 
站 中 ， 并 在 其 他 网 页 中 引用 Gist 中 粘贴 的 数据 。 作 为 GitHub 的 一 个 子 网 站 ， 很 自然 地 ，Gist 使 
用 Git 版 本 库 对 粘贴 数据 进行 维护 ， 这 非常 酷 。 


6.1.1. 数据 的 粘贴 和 引用 


进入 Gist 网 站 的 首页 ， 就 会 看 到 一 个 大 大 的 数据 粘贴 对 话 框 ， 如 图 6-2 所 示 。 


图 etgahub Dashboard — Inbox Account Settings Log Qut 


a A 
Ithub: ^5: 
, z Now 四 k [snis pe tsi [LS DET. Ti Iacx 55 ih [er 


Giai is a simple way 1o ahane anippete and 
paatas with ater. All gist are git 
repositores, so hey are autoratically 
versioned, forkable and usable as à git 
repository. 


Language: Pian Txi 


g Add another file... 


CA Create Private Gist 3 Create Public Gist 


图 6-2 : Gist 网 站 首页 


只 要 提供 一 行 简单 的 描述 、 文 件 名 ， 并 粘贴 文件 内 容 ， 即 可 创建 一 个 新 的 粘贴 。 创 建新 的 煌 
贴 时 ， 如 果 不 指 定 文件 名 ， 将 由 系统 上 自动 指派 。 如 图 6-3 所 示 。 


Calculate the countdown for the meeting of the party. 


countdown. rb language detected by filename 


$!/usr/bin/ruby 
# Calculate the countdown for the meeting of the party. 


require 'Date' 


dayse(DateTime,new(2012,10,15)-DateTime.now).ceil 
puts "Maybe £[days) days left." 








o Add another file... 





AÀ Create Private Gist © Create Public Gist 


图 6-3 : 创建 新 的 Gist 


每 一 个 新 的 粘贴 称 为 一 个 Gist， 并 拥有 唯一 的 URL。 如 果 选 择 创 建 公 开 的 Gist，URL 中 将 使 用 
顺序 递增 的 ID 号 ， 如 本 例 创 建 的 Gist 的 URL 地 址 为 : https;/gist.github.com/1202870 。 


若 选 择 创 建 私有 Gist，URL 中 则 采用 20 位 十 六 进 制 数字 的 ID， 例 如 私 才 

Gist : https://gist.github.com/78d67164131ec9e08dfe。 需 要 指出 的 是 ， 私 有 Gist 的 私密 性 并 
不 像 GitHub 私 有 版 本 库 的 私密 性 那么 强 ， 只 是 其 URL 没 有 在 用 户 Gist 列 表 中 列 出 ， 也 不 能 通过 
Gist 网 站 搜索 到 而 已 。 如 果 用 户 知道 某 私密 Gist 的 URL 地 址 ， 同 样 可 以 访问 、 克 隆 该 私密 
Gist， 甚 至 创建 基于 该 Gist 创 建 分 支 (fork) 。 


当 一 个 粘贴 创建 完毕 后 ， 会 显示 新 建立 的 Gist 页 面 ， 如 图 6-4 所 示 。 


nio yas edit * download / | * unstar * r] getgithub 
a 

Public Lape UAL: gt:/gist.gahub.com/12028 70.gt 

Privata Clone URAL: git gist github.com: 1202870 git Revisions 


Embed Al Filg aheow embed 
e ddai Quübglti.wub jesi now 


min 


paniyan rb f embed "aod 


require "Date 


dayse[(D2atezime.mgwd(2212,10,15]-DateT ime, now) cll 
pata "Maybe F[(daya) days left." 


开本 的 二 res gest 


Wria Prendas Comanents ara Darsoed with GitHub F eeni Marin 


Adi Gat Comement 


图 6-4 : 新 创建 的 Gist 


点 击 其 中 的 "embed” (WA) 按钮 ， 就 会 显示 一 段 用 于 瞬 入 其 他 网 页 的 JavaScript 代 码 ， 如 图 
6-5 所 示 。 


countdown.rb £ 





图 6-5 : X :;rkskAXJava 


I$ A hJ Ak A JavaScripti TF : 


«script src="https://gist.github.com/1202870.js?file=countdown.rb"></script> 


it Lm JavaScript REAA (如 博客 [2]) P > TERE kA A PA R B Gistt c 
据 ， 并 保持 语法 加 亮 等 功能 ， 如 图 6-6 所 示 。 


Gist2 die Ek A RE 


FEHRANRuby AAA., XE gist.github.com 


require 'Date 


daysm[DateTime.mew([2012,10,15)-DateTime.now) .ceil 
puts "Maybe NK[daya) days left. 


This Gist brought to you by GitHub countdown.rb view raw 


1313] http:/ /gotgit.github.com/gotgithub/ ARa FA €GotGitHub? . 


图 6-6 : 博客 中 引用 Gist 数 据 


6.1.2. Gist 背 后 的 Git 库 


创建 的 每 一 个 Gist 的 背后 都 对 应 着 一 个 Git 版 本 库 。 例 如 之 前 创建 的 ID 为 1202870 的 Gist 对 应 的 
Git 版 本 库 ， 可 以 使 用 两 种 协议 进行 访问 : 


e Git : git://gist.github.com/1202870.git 
e SSH? : git@gist.github.com:1202870.git 


可 以 通过 Git 命 令 克 隆 和 操作 该 版 本 库 。 


e 克隆 该 Gist 对 应 的 版 本 库 。 


$ git clone gitQgist.github.com:1202870.git 
$ cd 1202870 


e 查看 修改 日 志 。 每 一 次 对 Gist 中 文件 的 修改 对 应 于 一 次 提交 。 


$ git log 

commit 993d28a1319eca314ab2e3f4c46882cf 328e5ff9 
Author: GotGitHub «gotgithubQgmail.com-» 

Date: Thu Sep 15 15:41:10 2011 +0800 


commit A4dd9cfd54e1522d0b62d92dd5f705a61e3fe8778 
Author: GotGitHub «gotgithubQgmail.com-» 
Date: Thu Sep 8 00:46:50 2011 -0700 


e 查看 最 近 一 次 更 改 。 


$ git show HEAD 

commit 993d28a1319eca314ab2e3f4cA46882cf 328eb5ff9 
Author: GotGitHub «gotgithubQgmail.com-» 

Date: Thu Sep 15 15:41:10 2011 +0800 


diff --git a/countdown.rb b/countdown.rb 
index a9d747b..9045738 100644 

--- a/countdown.rb 

+++ b/countdown.rb 

QQ -4,4 *4,8 QQ 


require 'Date' 


days-(DateTime.new(2012,10,15)-DateTime.now).ceil 
-puts "Maybe #{days} days left." 
\ No newline at end of file 
+if days >= 0 
+ puts "Maybe #{days} days left." 
*telse 
+ puts "Passed for z(days.abs) days." 
+end 
\ No newline at end of file 


Gist 网 站 并 没有 像 GitHub 网 站 那样 对 于 Git 版 本 库 提 供 完整 的 、 近 乎 复杂 的 操作 界面 和 工作 流 
支持 ， 而 只 提供 了 最 基本 的 操作 界面 。 如 图 6-7 所 示 。 


gist: 1202870 (efi) ( 4 download | | * unstar * 图 gotgithub 
Calculate th£e counbdewn Tor the meeting ol the party. edt 
gàá-/lgist.gahub.com/1202870. git 
yt est githuh Tri TT 


Ta 








requires DATA 
dayae[DateTime.new[2012,10,15]-DaveTime. now) .cmi1 
if days »- 站 

puta Eayseo FIGOAYABL days LPEE. 
alae 

puts FAIRG ior FIdATR.AàDbA) GhYS. 


nz 


图 6-7 : Gisth AÈ fa] H STE AF d 


在 这 个 简 多 的 Git 版 本 库 操作 界面 中 ， 堪 侧 是 版 本 库 的 简介 、 文 件 预览 以 及 在 线 编辑 、 下 载 、 
加 注 星 标 ( 对 感 兴趣 的 Gist 进 行 收藏 ， 参 见 博客 https://github.com/blog/673-starring-gists)、 版 
本 库 分 支 ( 访 问 他 人 创建 的 Gist 时 ， 提 供 分 支 功 能 按钮 。) 等 相关 操作 按钮 。 若 以 Gist 创 建 者 登 


录 ， 会 在 右 侧 看 到 他 人 基于 该 Gist 创 建 分 支 的 情况 ， 但 是 并 不 提供 GitHub 才 有 的 Pull Request 
等 功能 。 在 界面 的 右 侧 还 显示 了 Gist 修 订 历 史 ， 和 之 前 通过 git log 命 令 从 Git 版 本 库 看 到 的 一 
样 。 


6.1.3. Greasemonkey 


Gist 除 了 被 用 于 粘贴 数据 (如 代码 块 ) 并 在 网 页 中 引用 之 外 ， 还 被 用 户 挖 握 出 了 新 的 应 用 模 
式 ， 例 如 用 作 Greasemonkey 脚 本 的 维护 [5] 。 


Greasemonkey[6] 或 类 似 插 件 为 浏览 器 提供 用 户 端 JavaScript 扩 展 功 能 ， 最 早出 现 于 FireFox 
浏览 器 中 。 其 他 浏览 器 也 陆续 增加 了 对 用 户 端 JavaScript 的 支持 ， 如 Safari 的 er 
件 ，|E 的 Trixie[8] 插 件 ， 以 及 Chrome 的 Greasemetal 插 件 ( 版 本 4 之 后 的 Chrome 内 置 
Greasemonkey 类 似 功 能 ， 无 需 额外 插件 。)。 关 于 如 何在 浏览 器 中 安装 并 启用 相应 um i 
参照 相关 插件 网 站 的 介绍 ， 在 此 不 做 过 多 叙述 。 


当 浏 览 器 安装 了 Greasemonkey 或 类 似 插 件 之 后 ， 当 访问 扩展 名 为 .user.js 的 URL 时 ， 会 将 该 
URL 指 向 的 JavaScript 脚 本 安装 在 浏览 颈 中 ， 当 访问 指定 的 网 址 时 会 目 动 调 用 相应 的 
JavaScript 脚 本 ， 修 改 相 关 网 页 内 


我 针对 《Git 权 威 指 P TR 官网 的 测试 网 页 写 了 一 个 Greasemonkey 示 例 脚本 ， 可 以 展示 用 户 端 
JavaScript 的 魔法 ， 这 个 用 户 端 JavaScript 脚 本 保存 在 Gist 
中 : https://gist.github.com/1084591， 如 图 6-8 所 示 。 


ist: ; + dwnlaad f bk * sar E 
gist: 1084581 a Eve 
Add toggle bution af the anchor with .clickmone style 
yid mast.othub comi 1034591 qi 
Revisions 
mue di OSsxp-com | 
- Th 


图 6-8 : 保存 Greasemonkey 用 户 端 脚本 的 Gist 


该 Greasemonkey 脚 本 的 文件 名 为 click_more.user.js， 该 文件 的 文件 头 使 用 特殊 的 注释 语句 为 
Greasemonkey 提 供 相 关 的 安装 和 注册 信息 ， 内 容 如 下 (为 方便 描述 添加 了 行 号 ) 


1 // --UserScript-- 

2 // Qname Click more for toggle 

3 // Qnamespace gotgit 

4 // Qdescription Add a toogle effect at the location where anchor with a click-more 
5 // Qinclude http://www.worldhello.net/gotgit/demo* 

6 // Qinclude http://gotgit.github.com/gotgit/demo* 

7 // Qinclude http://www.ossxp.com/doc/gotgit/demo* 

8 // Qrequire http://code.jquery.com/jquery-1.6.2.min.js 

9 // --/UserScript-- 





SS 


Got Github 


其 中 第 5、6、7 行 三 条 include 语 名 限定 了 此 用 户 端 JavaScript 脚 本 的 应 用 范围 ， 即 只 针对 指定 
的 URL (使 用 通配符 ) 执行 该 脚本 。 第 8 行 设 定 脚 本 依赖 ， 即 该 脚本 依赖 jQuery， 会 在 运行 前 
到 指定 的 URL 地 址 加 载 jQuery 脚 本 。 


在 安装 该 脚本 前 ， 先 用 浏览 器 访问 网 址 http://www.worldhello.net/gotgit/demo.html， 看 看 不 加 
载 用 户 端 JavaScript 脚 本 时 网 页 的 模样 。 该 网 页 中 包含 一 个 长 长 的 网 上 书店 列表 ， 如 图 6-9 所 
示 。 
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http: / /ww'w.bjbb.com/bookdetail.aspx?pid-2377518B 


* 


图 6-9 : 应 用 用 户 端 JavaScript 脚 本 前 的 网 页 内 容 


接 下 来 开始 安装 该 用 户 端 JavaScript 脚 本 。 安 装 非常 简单 ， 只 要 点 击 图 6-8 的 Gist 当 中 的 脚本 文 
件 对 应 的 “raw” 链 接 ， 即 点 击 脚本 文件 原始 内 容 链 接 [10] 即 可 开启 安装 。 这 是 因为 该 URL 

以 .Userjs 结 尾 ， 会 被 Greasemonkey (或 类 似 插 件 ) 识别 并 安装 ， 如 图 6-10 是 Greasemonkey 
弹出 的 用 户 端 脚本 安装 界面 。 
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Got Github 


这 是 Greasemonkey HARE, EeBIEBDEAIBABGEE*. 


——^^—————————»———Ó 
| Click more for toggle 
Add a Toome effect at the location where anchor with 


peera 

| http: //www.wnorldhello.net/gotgit/demo* 
|http: //gotgit.github.com/gotgit/demo* 

| http: //www.ossxp.com/doc/gotgit/demo* 


CENAE 0822 TOL RA FE Ze DT ETE TL ELTE B er 
运行 。 


您 应 该 只 安装 从 可 信任 来 源 获得 的 脚本 。 
































| 显示 脚本 源 代 码 | | ”取消 | 


图 6-10 : 4X Jl] P JavaScripti +% 


用 户 端 脚本 安装 完毕 后 ， 再 访问 同样 的 测试 网 页 http://www.worldhello.net/gotgit/demo.html， 
会 发 现 网 页 中 出 现 了 一 个 名 为 “更 多 ”的 可 点 击 链接 ， 长 长 的 网 上 书店 列表 不 见 了 。 如 图 6-11 所 


示 。 


7# + China-pub 互动 出 版 网 
males http:/ /product.china-pub.com/194010 
HERS 
X 3 * FEM 
WEER http: / /ww'w.amazon.cn/gp/product/BOOSBFLCAO/ 
€ 当当 网 
http: / /product.dangdang.com/product.aspx?product id-21108669 
. NFER 


http: / /book.360buy.com/10697183.html 


ES... 


图 6-11 : 应 用 用 户 端 JavaScript 脚 本 后 的 网 页 内 容 


如 果 查 看 网 页 源码 ， 会 发 现 该 网 页 中 根本 没有 包含 和 调用 任何 JavaScript 脚 本 ， 只 是 在 页 面 源 
码 中 包含 着 一 个 没有 任何 实质 输出 的 标签 : 


<p><a class="click-more"></a></p> 
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实际 上 正 是 这 个 特殊 的 标签 被 Greasemonkey 所 加 载 的 用 户 端 脚本 识别 ， 为 HTML 网 页 添加 了 
特效 o 
6.1.4. 命令 行 操作 Gist 


GitHub 开 发 者 还 写 了 一 个 名 为 gist 的 命令 行 工 具 对 Gist 进 行 操 作 ， 地 址 见 
https://github.com/defunkt/gist » 


该 工具 使 用 Ruby 开 发 ， 对 两 个 特定 的 Git 风 格 的 配置 变量 进行 如 下 设置 后 ， 即 可 实现 在 命令 行 
中 自动 以 特定 用 户 身份 登录 操作 Gist。 


$ git config --global github.user "your-github-username" 
$ git config --global github.token "your-github-token" 


其 中 github.token 中 保存 的 是 用 户 的 API TOKEN， 这 在 “2.1 创建 GitHub 账 号 "一 节 有 过 介绍 。 
使 用 gist 命 令 行 工具 创建 新 的 Gist 非 常 简单 。 


e 创建 包含 一 个 文件 (如 script.py) 的 Gist， 使 用 如 下 命令 。 
$ gist script.py 

e 创建 包含 多 个 文件 的 Gist， 使 用 类 似 如 下 的 命令 。 

$ gist script.js notes.txt 


如 果 对 命令 行 操作 方式 感 兴 趣 ， 参 考 gist 工 具 网 站 的 README 文 件 。 


6.2. 其 他 版 本 控制 工具 支持 


如 果 曾 经 有 人 对 GitHub 只 提供 唯一 的 版 本 库 格 式 (Git) 托管 表示 过 怀疑 的 话 ， 那 么 今天 看 
到 GitHub 对 其 他 版 本 控制 工具 提供 的 愈 发 完善 的 支持 ， 和 争议 应 该 烟消云散 了 吧 。 


6.2.1. HI SVNi E GitHub 


2008 年 4 月 1 日 ，GitHub 宣 布 推 出 基于 SVN 的 SVNHub 网 站 ， 后 证 实 这 是 一 个 恩人 节 玩 笑 [1] » 
2010 年 黑人 节 ， 类 似 消息 再 起 ， 可 这 一 次 不 再 是 玩笑 [2]。 即 对 于 GitHub 上 的 每 一 个 Git 版 本 
库 ， 现 在 都 可 以 用 SVN 命 令 进 行 操 作 。 更 酷 的 是 SVN 版 本 库 使 用 的 是 和 Git 版 本 库 同 样 的 地 
址 [3] 。 


例如 用 下 面 的 Git 命令 访问 本 书 的 Git 版 本 库 ， 显 示 版 本 库 包 含 的 引用 。 其 中 分 支 master 用 于 
维护 书稿 ， 分 支 gh-pages 保 存 书稿 编译 后 的 HTML 网 页 用 于 在 GitHub 上 显示 。 


$ git ls-remote --heads https://github.com/gotgit/gotgithub 
cebd3dda9b9ce8ec90def1da10181a094bea152f refs/heads/gh-pages 
c4d370bibObafbi103dei14e104ca18b8c31d80add refs/heads/master 


如 果 使 用 SVN 命令 访问 相同 的 版 本 库 地 址 ，Git 服务 器 变 身 为 一 个 SVN 服务 器 ， 将 Git 的 引 
用 对 应 为 SVN 风格 的 分 支 。 如 下 : 


$ svn ls https://github.com/gotgit/gotgithub 
branches/ 

trunk/ 

$ svn ls https://github.com/gotgit/gotgithub/branches 
gh-pages/ 


SVN 支持 部 分 检 出 ， 下 面 命 令 将 整个 主线 trunk (相当 于 Git 版 本 库 的 master 分 支 ) 检 出 。 


$ svn checkout https://github.com/gotgit/gotgithub/trunk gotgithub 
A gotgithub/Makefile 
A gotgithub/README.rst 


Checked out revision 390. 
还 可 以 使 用 SVN 命令 创建 分 支 ， 即 相当 于 在 Git 版 本 库 中 创建 新 的 引用 。 测 试 发 现 GitHub 53 
不 支持 SVN 远程 拷贝 创建 分 支 ， 需 要 通过 本 地 拷贝 再 提交 的 方式 创建 新 分 支 。 操 作 如 下 : 


1. 为 避免 检 出 版 本 库 所 有 分 支 过 于 耗 时 ， 在 检 出 时 使 用 --depth=empty 参 数 。 


$ svn checkout --depth=empty \ 
https://github.com/gotgit/gotgithub gotgithub-branches 
Checked out revision 30. 


1. 进入 到 检 出 目录 中 ， 更 新 出 trunk 和 branches 两 个 顶级 目录 。 


$ cd gotgithub-branches 
$ svn up --depthzempty trunk branches 


A trunk 
Updated to revision 30. 
A branches 


Updated to revision 30. 


1. 通过 拷贝 从 主线 trunk 创 建 分 支 branches/svn-github 。 


$ svn cp trunk branches/svn-github 
A branches/svn-github 

$ svn st 

A + branches/svn-github 


提交 完成 分 支 创 建 。 


$ svn ci -m "create branch svn-github from trunk" 
Authentication realm: «https://github.com:443» GitHub 
Username: gotgithub 

Password for 'gotgithub': 

Adding branches/svn-github 


Committed revision 31. 


1. | Git 命令 可 以 看 到 服务 器 上 创建 了 一 个 新 的 同名 引用 ， 并 且 指 向 和 master 一 致 。 


$ git ls-remote --heads https://github.com/gotgit/gotgithub 


cebd3dda9b9ce8ec90def1da10181a094bea152f refs/heads/gh-pages 
c4d370bdbObafbi103dei14e104ca18b8c31d80add refs/heads/master 
c4Ad370b1bObafbi03dei14e104ca18b8c31d80add refs/heads/svn-github 


下 面 尝试 一 下 用 SVN 命令 在 新 创建 的 分 支 Svn-github 中 提交 


1. 进入 到 之 前 检 出 完整 主线 trunk 的 gotgithub 目 录 ， 并 将 工作 区 切换 为 分 支 branches/svn- 
github » 


$ cd ../gotgithub 
$ svn switch https://github.com/gotgit/gotgithub/branches/svn-github 
At revision 31. 


1， 人 和 修改 文件 ， 查 看 工作 区 状态 。 


$ svn st 
M 06-side-projects/040-svn.rst 


1. 用 SVN 提交 。 


$ svn ci -m "GitHub svn client support improved. Refs: http://git.io/svn" 
Sending 06-side-projects/040-svn.rst 

Transmitting file data . 

Committed revision 32. 


1， 同 样 查看 Git 版 本 库 的 更 新 ， 会 发 现 Svn-github 分 支 的 指向 已 和 master 不 同 。 


$ git ls-remote --heads https://github.com/gotgit/gotgithub 
cebd3dda9b9ce8ec90def1da10181a094bea152f refs/heads/gh-pages 
c4d370bidbObafbi103dei14e104ca18b8c31d80add refs/heads/master 
64b80cb5331e28fdfb896e2ab3085779bf6ca019 refs/heads/svn-github 


6.2.2. 用 Hg 操作 GitHub 


Hg (又 称 Mercurial) 和 Git 一 样 也 是 一 个 被 广泛 使 用 的 分 布 式 版 本 库 控制 工具 。 如 果 一 个 就 
i& Hg 的 开发 者 参与 托管 在 GitHub 上 的 项 目 ， 大 可 不 必 为 更 换 版 本 控制 工具 而 苦恼 ，GitHub 
上 的 一 个 名 为 hg-git[1] 的 开源 项 目 可 以 帮 上 忙 。 

得 益 于 Hg 的 强大 的 插件 扩展 机 制 ， 安 装 hg-git 并 将 其 注册 为 Hg 插件 后 可 提供 Hg 操作 Git 版 
本 库 的 能 力 。 安 装 hg-git 可 以 直接 使 用 easy. install 命令 : 


$ sudo easy install hg-git 


还 可 以 直接 从 GitHub 上 下 载 hg-git 最 新 代码 进行 安装 : 


curl -L -k -o hg-git.zip https://github.com/schacon/hg-git/zipball/master 
unzip hg-git.zip 

cd schacon-hg-git-* 

sudo easy install . 
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插件 hg-git 依赖 于 Dulwich 项 目 ， 如 果 在 安装 过 程 遇 到 Dulwich 无 法 编译 ， 可 能 是 因为 缺乏 
C 编译 路， 或 者 尚未 安装 python-dev 软件 包 。Dulwich 是 一 个 Python 语言 的 Git 实现 ， 因 此 
hg-git 在 运行 过 程 中 无 需 Git 命令 行 。 


和 其 他 Hg 插件 类 似 ， 安 装 完毕 后 需要 修改 Hg 配置 文件 (如 文件 ~/.hgrc ) 如 下 ， 以 启用 hg- 
git 插件 以 及 另外 一 个 必须 的 Hg 内 置 插件 一 一 bookmarks 插件 。 


[extensions] 
bookmarks - 
hggit - 


对 hg-git 安装 配置 完毕 ， 就 可 以 使 用 Hg 操作 Git 版 本 库 了 。 
e 克隆 Git 版 本 库 。 


$ hg clone git://github.com/ossxp-com/hello-world.git 
$ cd hello-world 


e Git 版 本 库 的 分 支 转换 为 Hg 版 本 库 中 的 bookmarks ? 


新 元 隆 的 Hg 版 本 库 黑 认 会 更 新 到 最 新 提交 (Pp tip 版 本 ) ， 未 必 处 于 所 需 的 分 支 上 。 用 
命令 hg bookmarks 显 示 分 支 列表 ， 人 命令 hg parents 显 示 工 作 区 对 应 的 版 本 。 


$ hg bookmarks 


helper/master 10:2767ad9d7008 
helper/v1.x 8:994c2f0adcOb 
master 1:dcd365e3175c 
$ hg parents 
修改 集 : 12:928384ca1e87 
ARR jx/v1.0-i18n 
标签 ， tip 
A Jiang Xin «jiangxinQossxp.com» 
日 期 : Fri Dec 31 12:12:42 2010 +0800 
摘要 : Translate for Chinese. 


e 切换 到 所 需 的 工作 分 支 (如 master 分 支 ) » 


用 hg update -r 命 令 切换 分 支 。 之 后 执行 hg bookmarks 命 令 会 看 到 当前 工作 分 支 用 星 号 
标识 出 来 。 


$ hg update -r master 


$ hg book 
helper/master 10:2767ad9d7008 
helper/v1.x 8:994c2f0adcOb 
* master 1:dcd365e3175c 


e Git 的 里 程 碑 也 被 记录 ， 并 可 被 hg tags 命令 显示 。 


$ hg tags 
tip 12:928384ca1e87 
jx/v1.0-118n 12:928384ca1e87 


jx/v2.3 10:2767ad9d7008 


e 使 用 hg pull 命 令 和 hg push 命 令 可 以 实现 和 Git 版 本 库 的 同步 。 


e 有 的 命令 如 hg outgoing TE 1.7 版 本 的 Hg 中 运行 正常 ， 但 对 于 高 版 本 库 的 Hg 存在 兼容 
性 问题 。 


实际 上 hg-git 插件 并 非 只 针对 GitHub 的 版 本 库 ， 而 是 可 以 支持 任意 Git 版 本 库 包 括 本 地 Git 
版 本 库 。 为 了 提供 对 Git 版 本 库 的 透明 支持 ， 对 Git 版 本 库 的 URL 的 写法 有 特殊 要 求 ， 即 要 
能 够 从 协议 名 称 区 分 开 Git 版 本 库 和 默认 的 Hg 版 本 库 。 


e Git 协 仅 : 
git://example.com[:port]/path/to/repo.git 
e SSH: 
git-ssh://[user(o]example.com[:port]/path/to/repo.git 
e HTTP X : 


git-http://[user(]example.com[:port]/path/to/repo.git 


e HTIPST : 
git 
e 本 地 协议 : 


/path/to/repo.git 
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GitHub f& 9d Web/IR 4- > EEP 35 i8 38 A S RD, KAGIT ALRT VATES XT o 而 
GitHub 还 开发 了 一 些 客户 端 工具 ， 以 便 用 户 有 更 好 的 客户 端 体验 。 


6.3.1. github:mac 


GitHub 专 为 Mac 用 户 开 发 了 一 款 图 形 化 客户 端 应 用 github:mac， 在 Mac 下 操作 GitHub 更 简单 。 
软件 下 载 地 址 : http://mac.github.com/。 


github:mac 可 以 实现 版 本 库 克 隆 、 查 看 历史 、 提 交 、 分 支管 理 、 与 GitHub 同 步 等 功能 。 图 6- 
12 展 示 的 是 提交 界面 ， 在 提交 界面 中 同时 显示 了 变更 的 差异 比较 ， 用 户 可 以 挑选 文件 中 的 部 
分 变更 进行 提交 ， 显 然 这 个 操作 要 比 在 命令 行 中 执行 git add -patch 或 git commit -patch % 
更 加 直观 。 
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图 6-12 : 算 选 文件 中 的 部 分 更 改进 行 提交 


github:mac 和 GitHub 深 度 集成 ， 当 配置 好 关联 的 GitHub 账 号 后 ， 会 自动 在 本 地 创建 专用 的 
SSHZ-4H [A^ 48 x1 3C fF ~/.ssh/github_rsa (如 果 该 文件 不 存在 的 话 ) ， 然 后 将 公 钥 文件 传递 到 
GitHub 网 站 并 上 自动 完成 配置 。 新 增 的 SSH 公 钥 文 件 显示 在 GitHub 网 站 的 账号 设置 中 ， 如 图 6- 
13 所 示 : 


Public Profile 5 My Mac Os X (edit 


Account Admin p Key on Windows [edit] 























Email Addresses 


Add another public key 


SSH Public Keys 
Our RSA fingerprint is 146:27:ac:35:78:28:20:346:63:1 b:56:4d:eb:dfl:aé:48 


Job Profile 


K 6-13 : 在 GitHub 上 自动 添加 的 SSH 公 刷 

同时 github:mac 还 在 本 地 将 新 生成 的 私 钥 文件 添加 到 ssh-agent 认 证 代理 中 ， 这 样 一 旦 通过 
SSH 协议 连接 GitHub， 首 先 采 用 该 公 钥 / 私 钥 对 进行 身份 认证 。 用 下 面 的 命令 可 以 查看 添加 到 
ssh-agent 中 的 私 钥 文件 。 


$ ssh-add -1 
2048 aa:01:4f:d2:14:ba:5f:9f:8c:dc:b5:9d:44:cd:8e:18 /Users/jiangxin/.ssh/github rsa (RSA 





这 种 透明 的 公 角 认证 管理 非常 栈 ， 对 于 大 多 数 只 使 用 唯一 一 个 GitHub 账 号 的 用 户 来 说 是 非常 
方便 的 。 但 如 果 用 户 拥有 多 个 GitHub 账 号 并 需要 不 时 切换 账号 ， 这 种 实现 却 很 粮 糕 ， 会 导致 
认证 错误 。 因 为 当 Ssh-agent 认 十 代理 缓存 了 私 钥 后 ， 连 接 由 文件 ~/.Ssh/config 设置 的 SSH 别 
名 主机 无 法 使 用 指定 的 公 钥 / 私 钥 对 进行 认证 ， 寻 致 认 证 失败 。 


遇 到 GitHub 账户 SSH 认证 问题 ， 可 以 运行 下 面 命令 清空 ssh-agent 缓 存 的 私 钥 。 


$ ssh-add -d -/.ssh/github rsa 
Identity removed: /Users/jiangxin/.ssh/github rsa (/Users/jiangxin/.ssh/github rsa.pub) 


[S Rr 


6.3.2. hub 


对 于 命令 行 用 户 ，GitHub 提 供 了 名 为 hub 的 命令 行 工具 ， 对 Git 进 行 了 简单 的 封装 。 该 项 目 在 
GitHub 上 的 地 址 为 : https://github.com/defunkt/hub ° 


使 用 hub 可 以 在 命令 行 中 简化 对 GitHub 的 操作 。 例 如 克隆 本 电子 书 的 版 本 库 ， 若 用 hub 命 令 ， 
地 址 可 大 大 简化 : 


$ hub clone gotgit/gotgithub 
若 要 在 自己 账号 下 创建 派生 项 目 ， 无 需 登录 GitHub 网 站 ， 直 接 通 过 命令 行 即 可 实现 : 


$ cd gotgithub 
$ hub fork 


女装 hub 很 简单 ， 可 使 用 如 下 方法 任意 一 种 方法 。 


e 克隆 hub 的 版 本 库 ， 从 源码 安装 。 安 装 步 骤 如 下 : 


$ git clone git://github.com/defunkt/hub.git 
$ cd hub 
$ rake install prefix-/usr/local 


n> J+ 


e 用 RubyGems EF XX ° 
hub 用 Ruby 开发 ， 也 可 用 RubyGems EFJ AVE. ° FRAS AREF RA hub 
4T 6,7] — k A BITRA 0 AR GE FTD SEE RubyGems WR » R amRRR o RKP 
如 下 : 


$ gem install hub 
$ hub hub standalone » -/bin/hub && chmod 755 -/bin/hub 


安装 完毕 后 ， 还 需要 对 hub 进 行 设置 。 定 义 两 个 Git 风 格 的 配置 变量 ， 以 便 hub 命 令 能 确定 当前 
GitHub 用 户 账 号 ， 并 能 够 完成 所 需 的 GitHub API 认证 。 


$ git config --global github.user "your-github-username" 
$ git config --global github.token "your-github-token" 


其 中 github.token 中 保存 的 是 用 户 的 APl TOKEN， 这 在 “2.1 创建 GitHub 账 号 ?一 节 有 过 介绍 。 


在 使 用 hub 过 程 中 ， 如 果 要 为 区 分 哪些 命令 是 git 的 ， 哪 些 是 hub 的 ， 而 不 断 在 两 个 命令 间 切 换 

显然 太 不 方便 了 。hub 命令 支持 以 系统 别名 git 的 方式 运行 ， 即 设置 hub 的 系统 别名 为 git， 然 后 
只 需 执 行 git 命 令 ， 这 样 无 论 是 git 本 身 的 命令 还 是 hub 扩 展 的 命令 都 可 正常 运行 。 但 要 注意 要 用 
系统 提供 的 别名 方式 ， 而 不 能 把 hub 脚 本 改名 为 git ， — 单 地 对 Git 进 行 封装 ， 运 行 
时 仍 依 束 git 命令。 在 bash 环境 下 建立 别名 可 运行 如 下 命 


$ alias git=hub 


其 他 shell 环境 下 如 何 建 立 系统 别名 呢 ? 运行 hub alias 命令 查看 相关 shell 环境 下 建立 别名 的 
方法 。 例 如 对 于 cesh : 


$ hub alias csh 
Run this in your shell to start using hub as git : 
alias git hub 


下 面 介绍 hub 的 常用 命令 ， 节 选 自 hub 的 项 目 页 [1]。 示 例 使 用 了 别名 命令 git 调 用 ， 并 把 对 应 的 
原始 的 git 命 令 写 在 命令 «TR (用 提示 符 > 表 示 ， 方 括号 中 是 说 明 ) e 
e git create 


在 GitHub 上 创建 项 目 。 


V € 


V € 


git create -d 
[ 在 GitHub 上 创建 版 本 库 ] 
git remote add origin gitQgithub.com:YOUR USER/CURRENT REPO.git 


' 项 目 表述 ， 


git create recipes 
[ 在 GitHub 上 创建 版 本 库 ] 
git remote add origin gitQgithub.com:YOUR USER/recipes.git 


git create sinatra/recipes 
[ 在 组 织 账号 sinatra 下 创建 版 本 库 ] 
git remote add origin gitQgithub.com:sinatra/recipes.git 


git clone 


克隆 版 本 库 可 使 用 URL 简 写 ， 即 "用 户 名 /版 本 库 ? 格 式 地 址 会 自动 扩展 为 Git 协 议 ( 


地 址 或 SSH 协 议 (可 写 ) 地 址 。 


git 
git 
git 
git 
git 
git 


clone 
clone 


clone 
clone 


clone 
clone 


schacon/ticgit 
git://github.com/schacon/ticgit.git 


-p schacon/ticgit 
gitàgithub.com:schacon/ticgit.git 


resque 
gitQgithub.com/YOUR USER/resque.git 


V € 


V € 


git fork 


在 GitHub 目 己 账号 下 建立 派生 项 目 。 


git fork 

[ 先 在 GitHub 上 建立 派生 项 目 ] 

git remote add -f YOUR USER gitQgithub.com:YOUR USER/CURRENT REPO.git 
git pull-request 

打开 编辑 器 输入 标题 和 内 容 ， 然 后 在 GitHub 上 创建 Pull Request 。 


git remote add 


设置 远程 版 本 库 。 和 git clone 命 令 一 样 支持 URL 简 写 。 
git remote add rtomayko 
git remote add rtomayko git://github.com/rtomayko/CURRENT REPO.git 


git remote add -p rtomayko 
git remote add rtomayko gitGgithub.com:rtomayko/CURRENT REPO.git 


git remote add origin 
git remote add origin git://github.com/YOUR USER/CURRENT REPO.git 


git fetch 


获取 他 人 同名 版 本 库 。 自 动 建立 远程 版 本 库 并 获取 提交 。 


$ git fetch mislav 
> git remote add mislav git://github.com/mislav/REPO.git 
> git fetch mislav 


$ git fetch mislav,xoebus 

> git remote add mislav ... 
2 
2 


git remote add xoebus ... 
git fetch --multiple mislav xoebus 


e git cherry-pick 
获取 远程 提交 ， 并 拣选 至 本 地 版 本 库 。 


$ git cherry-pick http://github.com/mislav/REPO/commit/SHA 
> git remote add -f mislav git://github.com/mislav/REPO.git 
> git cherry-pick SHA 


e git am, git apply 


获取 Pull Request， 并 应 用 于 本 地 版 本 库 。 


git am https://github.com/defunkt/hub/pull/55 
curl https://github.com/defunkt/hub/pull/55.patch -o /tmp/55.patch 
> git am /tmp/55.patch 


V € 


e git browse 


打开 浏览 器 访问 相应 的 URL 地 址 。 
$ git browse 
> open https://github.com/YOUR USER/CURRENT REPO 


$ git browse -- commit/SHA 
> open https://github.com/YOUR USER/CURRENT REPO/commit/SHA 


$ git browse -- issues 
> open https://github.com/YOUR USER/CURRENT REPO/issues 


$ git browse resque 
> open https://github.com/YOUR USER/resque 


$ git browse schacon/ticgit 
» open https://github.com/schacon/ticgit 


$ git browse schacon/ticgit commit/SHA 
» open https://github.com/schacon/ticgit/commit/SHA 


e git help hub 


查看 hub 命 令 的 帮助 。 


6.3.3. iOS 5 Jj 


GitHub 还 为 IOS 平 台 开 发 了 应 用 ， 这 样 就 可 以 在 iPhone ` iPad 等 苹果 设备 上 实时 跟踪 GitHub 
上 的 项 目 了 。 在 苹果 AppStore 上 搜索 GitHub 公 司 的 应 用 ， 可 以 找到 GitHub lssues 和 GitHub 
Jobs 等 应 用 ， 如 图 6-14 上 所 示 。 


GitHub 
iPhone 应 用 软件 排序 方法 : [menm : 
GitHub Issues GitHub Jobs 
工具 商业 
更 新 2011 年 10 月 31 日 更 新 2011 年 10 月 21 日 





图 6-14 : iPhone 上 的 issues 应 用 


在 iPhone 中 安装 GitHub lssues 应 用 ， 就 可 以 随时 查看 所 关注 的 GitHub 项 目的 问题 报告 和 Pul| 
Request 等 ， 如 图 6-15 所 示 。 


uil P [EEk ^ 下 午 7:38 


Back (e [e] (o [] ! 


closed 





P146 git rev-list --oneline F^! D 10/07/11 
P146 git rev-list --oneline F^! D 

结果 中 应 该 有 Commit GL ! ! ! ! ! | 

£2 xjmarui created #11 





p466: 公 钥 可 见 09/29/11 
图 32-8 中 的 公 钥 模糊 了 ， 但 是 公 钥 是 可 以 给 
别人 看 的 〈 安 全 的 ) ， 所 以 这 边 可 能 不 需要 


模 T 处 IE e 
二 larrycaicreated #10 








P459: http port to 8081 09/29/11 
t£ (7) 下 面 ， 例 子 可 能 应 该 是 。 
Listen on port [8080]: 8081 


ru 
8 larrycai created #9 





& 6-15 : iPhone 上 的 GitHub Issues M 


"2 GitHub Jobs 应 用 则 和 即将 要 介绍 的 GitHub 招 聘 网 站 有 关 ， 用 于 浏览 招聘 信息 。 


Got Github 


6.4. 其 他 


6.4.1. GitHub:Jobs 


GitHub R "sm > 于 2010 年 8 月 开通 ， 提 供求 职 招聘 服 务 [2]。 还 记得 在 “第 2.1 节 创建 
GitHubJK 5 "4-23 8348 X 7 4 0 
GitHub 就 会 帮助 用 户 了 寻找 合适 的 工作 机 会 ， 而 工作 机 会 就 来 自 于 GitHub 的 求职 网 站 ( 
16 所 示 ) 。 


Aljbs Postajob How lt worio 








Jobs Near You 

— E breuis E Folow GitHub Jobs on Twitter 

Ti Pari Tires 2 days mc 

More Hearby Jobs 一 Featured Company 

Featured Jobs | 
salesforce 

emen ——Q New Mobile Team forming Cupaer& na, CA j 

Pre-sales Engineer San Francisco, CA, US TUE S 

VE FRT) Ful Tier Aue Z3 201 pu " t 


Mare Awesome Jobs — GitHub Jobs IPheae App 


图 6-16 : GitHub 求 职 网 站 


个 人 用 户 除 了 开启 求职 状态 坐等 通知 外 ， 还 可 以 主动 出 击 ， 直 接 到 GitHub 求 职 网 站 上 了 寻找 合 
适 的 工作 机 会 ， 整 个 求职 过 程 是 免费 的 。 而 作为 企业 主 发 布 招 聘 启 示 则 是 收费 服务 ， 发 布 招 
聘 启 示 的 流程 如 图 6-17 所 示 。 





$350.00 — 





n F 
i par listing im z e - 
一 
Create & preview your listing Pay with a major credit card Your listing goes live immediately 
Sen exactly how your listing wil icok before Mrvorcing available on nsquesi Tor bulk orders Listings. ang live Tor 30 days. Wiot send you a 
you publish ve Emal bs github.com for mone indo. receipt and a link io change the listing. 


图 6-17 : 企业 主 发 布 招 聘 启 示 流 程 


6.4. 其 他 154 


企业 发 布 招聘 司 示 ， 首 先 要 按照 模版 十 写 职位 说 明 及 留 下 供求 职 者 投递 简历 的 邮件 地 址 ， 然 
后 用 信用 卡 付费 ， 每 一 个 招聘 启示 的 付费 标准 为 350 美 元 /月 。 一 旦 付费 完成 招聘 马上 生效 。 
GitHub 作 为 程序 员 的 聚集 地 ， 无 疑 是 招聘 和 应 聘 的 理想 之 地 。 


6.4.2. GitHub:Shop 


GitHub 商 店 [1] 销 售 着 一 些 你 在 其 他 地 方 买 不 到 的 小 东西 
念 品 ， 图 6-18 展 示 的 就 是 一 款 印 着 Octocat 的 杯子 。 


如 印 着 GitHub 吉 祥 物 Octocat 的 纪 








图 6-18 : 印 着 Octocat 吉 祥 物 的 杯子 


图 6-19 则 有 是 GitHub 热 卖 的 一 款 体 恤 的 前 后 两 面 的 图 委 设 计 [2]。 体 恤 前 面 印 着 GitHub 社 区 编程 
最 核心 的 理念 (fork you) ， 体 恤 后 面 则 可 以 用 记号 笔 写 下 你 在 GitHub 上 的 主页 地 址 。 





图 6-19 : 超 酷 的 GitHub 体 恤 


GitHub 商 店 实际 上 是 架设 于 Shopify[3] 电 子 商务 网 站 上 的 网 店 。GitHub 商 店 并 非 GitHub 主 业 ， 
销售 纪念 品 可 以 增强 GitHub 用 户 的 认同 感 ， 而 GitHub 粉 丝 可 以 购买 一 项 “装备 "让 自己 看 起 来 更 


酷 。 


6.4.3. GitHub 短 网 址 服务 
在 “第 2.2 节 浏览 托管 项 目 "一 节 介 绍 图 形 文件 差异 比较 时 ， 需 要 给 出 一 个 网 址 ， 但 这 个 网 址 很 
长 。 如 下 : 


https://github.com/cameronmcefee/Image-Diff-View- 
Modes/commit/8e95f/0c9c47168305970e91021072673d7cdad8 


很 自然 地 想到 了 Google 短 网 址 服务 ， 于 是 由 上 面 的 长 网 址 生成 出 一 个 短小 精干 的 网 
址 : http://goo.gl/Gy85b， 访 问 该 短 网 址 会 自动 重 定向 到 对 应 的 长 网 址 。 


2011 年 11 月 ，GitHub 也 推出 了 自己 的 短 网 址 服务 [1]， 为 GitHub 自 身 网 址 提供 短 网 址 转换 服 
务 。GitHub 短 网 址 服务 没有 像 Google 短 网 址 服务 那样 提供 基于 Web 的 图 形 化 转换 界面 ， 而 是 
需要 用 命令 行进 行 网 址 转换 。 


例如 对 于 网 址 https://github.com/blog/985-git-io-github-url-shortener 的 转换 ， 使 用 curl 命 令 如 
下 操作 。 


e 将 长 网 址 转换 为 短 网 址 。 
命令 curl 输 出 中 的 Location: 语 句 即 是 转换 后 的 短 网 址 。 
$ curl -i http://git.io -F 'url-https://github.com/blog/985-git-io-github-url-shortener' 


HTTP/1.1 201 Created 


Location: http://git.io/help 
-4 
e 查看 短 网 址 对 应 的 原 网 址 ， 同 样 使 用 curl 命 令 。 


命令 curl 输 出 302 重 定向 地 址 即 为 原始 网 址 。 


$ curl -i http://git.io/help 
HTTP/1.1 302 Found 


Location: https://github.com/blog/985-git-io-github-url-shortener 


为 使 转换 的 短 网 址 更 多 于 记忆 和 识别 ， 可 在 curl 命 令 中 用 code Air 3E 6 48 Pp bb o 45] de 
下 面 命令 将 本 节 一 开始 提 到 的 长 网 址 转换 为 短 网 址 : http:/git.io/image-diff 。 


$ curl -i http://git.io -F \ 
'url=https://github.com/cameronmcefee/Image-Diff-View-Modes/commit/8e95f70c9c4716830597 
-F 'code=image-diff' 

HTTP/1.1 201 Created 

Location: http://git.io/image-diff 


4 űñűñ oec  . - 





6.4.4. GitHub Open Source 


GitHub 已 成 为 新 的 开源 项 目 大 本 营 ， 而 且 GitHub 也 将 其 API 开 放 ， 并 将 部 分 模块 开源 ， 借 助 社 
区 的 力量 让 GitHub 变 得 更 好 。 


GitHub 大 部 分 的 开源 项 目 托管 在 其 官方 账号 下 : https://github.com/github ° 


APlI 接 口 


GitHub 通 过 域名 api.github.com 提 供 API 接 口 ， 数 据 以 JSON 格 式 传递 。 


详细 的 AP| 参 考 手册 参见 网 址 : http://developer.github.com/ 。API 手 册 的 版 本 库 地 址 : 
https://github.com/github/developer.github.com ° 


CATh 
GitHub 官 方 手册 参见 http://help.github.com/ > 44 F] Jekyll 2&4? » 


项 目地 址 : https://github.com/github/help.github.com 。 


Grit 


Grit 是 Git 的 Ruby 封 装 和 实现 ， 是 GitHub 调 用 Git 的 接口 。 部 分 是 通过 封装 对 git 命 令 的 调用 实现 
的 ， 部 分 则 十 纯 Ruby 实 现 。 


项 目地 址 : https://github.com/mojombo/grit ° 


GitHub Services 


Git 版 本 库 推 送 会 触发 服务 器 端 post-receive 钓 子 脚本 。 此 项 目 将 GitHub 的 服务 器 端 钓 子 脚本 开 
源 ， 用 户 可 以 开发 针对 特定 应 用 的 钧 子 。GitHub 还 为 其 他 GitHub 应 用 提供 了 事件 接口 ， 如 问 
题 变更 、Pull Request、 维 基 页 面 修改 等 [1] 。 


项 目地 址 : https://github.com/github/github-services 。 


Hubot 和 Hubot Scripts 


可 以 把 hubot[2]& tk x GitHub 3 Siri (最早 出现 于 iPhone 4S 的 智能 语音 助理 ) 或 是 新 浪 微 博 
上 的 饮水 姬 [3]。GitHub 将 hobot 和 Campfire 聊 天 宇 整 合 ，hobot 被 聊天 宇 会 话 触发 可 以 实现 诸 
如 : 打开 办 公 室 的 门 、 根 据 wifi 使 用 情况 列 出 公司 中 的 人 、 通 过 公司 喇叭 读 一 段 信 息 等 等 许多 
好 玩 的 事情 [4]， 而 实现 GitHub 和 上 自动 化 部 署 则 证 明 hubot 可 以 完成 更 严肃 的 事情 ， 在 公司 工作 
流 中 扮演 举足轻重 的 地 位 [5] 。 


Hobot 已 经 开源 ， 项 目 库 地 址 : https://github.com/github/hubot 和 
https://github.com/github/hubot-scripts (脚本 ) ° 


Gollum 


GitHub 以 Git 为 后 端的 维基 系统 就 是 由 Gollum 实 现 的 。 每 一 个 维基 网 页 对 应 于 一 个 文件 ， 文 件 
格式 可 以 是 Markdown ` textile » rdoc ` org ` creole ` mediawiki ` reStructuredText ^ 
asciidoc ` pod 等 。Gollum 调用 名 为 github-markup 的 Ruby gem & (来 自 于 下 面 要 介绍 的 
Markup 项 目 ) 完成 文件 到 网 页 的 格式 转换 。 


项 目地 址 : https://github.com/github/gollum ° 


关于 GitHub 维 基 参 见 本 书 “ 第 4.6 节 维基 ”。 


Jekyll 


Jekyll 是 一 个 简单 的 、 支 持 博客 的 静态 网 站 编译 器 。 可 以 使 用 Markdown 和 Textile 两 种 标记 语 
言 或 者 HTML 扎 写 网 页 ， 并 支持 Liquid 模 版 。 实 际 上 GitHub 为 托管 项 目 生 成 静态 网 页 使 用 的 就 
Æ Jekyll 。 


项 目地 址 : https://github.com/mojombo/jekyll » 


Linguist 


Linguist z& — ^^ Ruby/&2X > GitHub4 Jf] UB Hk 3t 23048 SC TE SETA GL ATE ^ AM) KAHTE BN 
类 ， 人 代码 加 亮 ， 对 二 进 制 文件 进行 忽略 ， 限 制 非 必须 的 差异 显示 ， 以 及 生成 语言 分 类 图 等 。 


项 目地 址 : https://github.com/github/linguist ° 


Markup 


GitHub 通 过 这 个 ruby 包 对 项 目 版 本 库 根 目录 下 的 README 文 件 ， 以 及 维基 页 面 等 文件 进行 解 
析 、 转 换 为 网 页 显示 。 支 持 Markdown 、textile、rdoc、org、creole、mediawiki、 
reStructuredText ` asciidoc ` pod 等 标记 语言 。 实 际 上 在 对 上 述 标记 语言 的 解析 和 转换 中 ， 还 
依赖 其 他 软件 包 ， 例 如 对 于 Markdown 格式 首选 Redcarpet(Redcarpet 是 对 一 个 高 效 的 


Markdown 解 术 器 ， 通 过 对 C 语 言 的 Sundown 库 封 装 实现 。 项 目地 
址 : https://github.com/tanoku/redcarpet ° ) > *1 textile 格式 使 用 RedCloth ， 对 
reStructuredText 格式 调用 外 部 命令 rst2html， 对 asciidoc 格式 调用 外 部 命令 asciidoc 等 。 


项 目地 址 : https://github.com/github/markup ° 
关于 Markup 软 件 包 以 及 其 他 GitHub 扩 展 的 Markdown 语 法 ， 参 
IL : http://github.github.com/github-flavored-markdown ° 


Resque 


Resque ( È X44 "rescue") 是 一 个 以 Redis 为 后 端的 Ruby 包 ， 用 于 创建 和 管理 后 台 任务 。 
可 创建 任务 ， 将 任务 分 配 到 多 个 队列 ， 并 在 后 人 台 执 行 任务 。 


项 目地 址 : https://github.com/defunkt/resque » 


GitPad 


这 是 一 个 运行 于 Windows 下 类 似 Notepad.exe 的 应 用 程序 ， 安 装 此 应 用 后 在 Windows 下 做 Git 
提交 操作 会 调用 类 似 记 事 本 (Notepad) 的 应 用 撰写 提交 说 明 。 


项 目地 址 : https://github.com/github/GitPad 。 


Maven Plugins 


GitHub 的 Maven 插 件 。 


项 目地 址 : https://github.com/github/maven-plugins 。 


Gitignore 


集合 了 针对 各 种 语言 环境 的 .gitignore (忽略 文件 ) 模版 。 例 如 其 中 针对 VisualStudio 的 忽略 文 
件 模 版 Global/VisualStudio.gitignore 部 分 内 容 如 下 


User-specific files 
.SUO 

.USer 

.Sln.docstates 


+ + o dE 


# Build results 
[Dd ]ebug/ 
[Rr ]elease/ 


项 目地 址 : https://github.com/github/gitignore ° 


Media 


提供 GitHub 网 站 Logo 和 吉祥 物 Octocat 的 图 片 ， 只 能 在 授权 范围 内 使 用 。 


项 目地 址 : https://github.com/github/media ° 


T. 附录 : 轻重 级 标记 语言 


没有 标记 语言 就 没有 Web 和 丰富 多 彩 的 互联 网 ， 但 创造 了 Web 的 HTML 语 言 并 非 尽 善 尽 美 ， 存 
在 诸如 难 读 、 难 写 、 难 以 向 其 他 格式 转换 的 问题 。 究 其 根源 是 因为 HTML 语 言 是 一 种 “ 重 ” 标 记 
语言 ， 对 机 器 友好 而 并 非 对 人 友好 。 


下 面 这 段 HTML 源 码 ， 非 技术 控 阅 读 起 来 会 遇 到 困难 。 


«html» 

«head» 
«meta content-'application/xhtml-xml;charset-utf-8' http-equiv-'Content-type' /> 
<title> 轻 量 级 标记 语言 </title> 

</head> 

<body> 
«hi id='id1'> 轻 量 级 标记 语言 </h1> 


<p><strong> 轻 量 级 标记 语言 </strong> 有 是 一 种 <em> 语 法 简单 </em> 的 标记 语言 。 
它 使 用 多 于 理解 的 格式 标记 ， 没 有 古怪 的 <code>&1t ;标签 &gt;</code> ° </p> 
«ul» 
<1i> 可 以 使 用 最 简单 的 文本 编辑 器 编辑 。</1i> 
<1i> 所 见 即 所 得 ， 非 技术 控 亦 可 直接 阅读 源码 。</1i> 
<1i> 可 版 本 控制 。</1i> 
<]i> 实 现 单一 源 文件 出 版 。</1i> 
«/ul» 
«body» 
«/html» 


同样 的 信息 如 果 换 用 轻 量 级 标记 语言 来 表达 ， 就 非常 直观 了 。 如 下 所 示 : 


轻重 级 标记 语言 


本 
它 使 用 易于 理解 的 格式 标记 ， 没 有 十 怪 的 `“` o 

- 可 以 使 用 最 简单 的 文本 编辑 器 编辑 。 

- 所 见 即 所 得 ， 非 技术 控 亦 可 直接 阅读 源码 。 

- 可 版 本 控制 。 

- 实现 单一 源 文件 出 版 。 


GitHub 令 人 痢 迷 的 一 个 因素 就 在 于 GitHub 为 用 户 提 供 更 为 便捷 地 创建 UGC (用 户 生 成 内 容 ) 
的 方法 ， 其 奥秘 就 在 于 使 用 了 轻 量 级 标记 语言 。 无 论 是 代码 提交 说 明 、 提 交 评 注 、 问 题 描 

述 、 项 目的 README 文 件 、 维 基 页 面 、 用 户主 页 和 项 目 主页 都 可 以 使 用 Markdown(Markdown 
是 在 Ruby 应 用 中 广泛 使 用 的 标记 语言 ， 语 法 简洁 并 可 混用 HTML。 标 准 的 Markdown 语 法 缺乏 
如 表格 等 关键 特性 的 支持 ， 虽 然 不 同 的 解析 器 都 对 其 语法 进行 了 扩展 ， 但 实现 各 有 不 同 ， 造 
成 一 定 的 混乱 。 网 址 : http://daringfireball.net/projects/markdown/ 。 等 轻 量 级 标记 语言 来 所 
号。 和 轻 量 级 标记 语言 如 Markdown 有 是 对 人 友好 的 标记 语言 ， 一 些 语法 参照 了 我 们 写 电 子 邮 件 时 
的 习惯 ， 即 使 第 一 次 接触 用 轻 量 级 标记 语言 撰写 的 文件 ， 也 可 以 党 无 障碍 地 理解 其 中 的 内 
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虽然 GitHub 更 倾向 于 使 用 Markdown 标 记 语 言 (GitHub 使 用 Redcarpet 作 为 Markdown 的 解析 工 
具 ， 并 添加 了 额外 的 语法 扩展 。 网 址 : http://github.github.com/github-flavored-markdown/， 
但 很 多 地 方 也 提供 对 其 他 轻 量 级 标记 语言 的 支持 。 包 括 为 Python 程 序 员 所 熟悉 的 
reStructedText(reStructuredText 可 简写 为 reST 或 RST， 是 在 Python 中 广泛 使 用 的 标记 语言 。 
reST 的 语法 简洁 严谨 ， 本 书 就 是 使 用 Sphinx 扩 展 的 reST 语 法 和 工具 撰写 的 。 网 

址 : http://docutils.sourceforge.net/rst.html， 为 Ruby 程 序 员 所 熟悉 的 Textile(Textile 是 在 Ruby 
应 用 中 广泛 使 用 的 标记 语言 ， 例 如 Redmine 就 将 Textile 作 为 内 置 的 标记 语言 。 网 

ht : http://redcloth.org/textile ` RDoc(RDocx Hi dx T Ruby4X48 F M T 2&AP AX 4E SCBI 8] 36i 
言 。 网 址 : http://rdoc.sourceforge.net/doc/ > 7? Perl£&/$ 5i Pr $8; & 9 POD(POD X A 4 T Perl 
代码 中 用 于 维护 软件 文档 的 标记 语言 。 网 址 : http://perldoc.perl.org/perlpod.html > Z; Emacs 
用 户 所 熟悉 的 Org-mode(Org-mode 是 Emacs 的 一 种 编辑 模式 ， 除 文档 外 还 被 广泛 应 用 于 维护 
TODO 列 表 、 项 目 计 划 等 。 网 址 : http://orgmode.org/org.html， 为 维基 用 户 所 熟悉 的 
MediaWiki(MediaWiki 是 著名 的 维基 百科 (WikiPedia) 所 使 用 的 维基 语言 。 网 

址 : http://www.mediawiki.org/wiki/Help:Formatting 和 Creole( 维 基 的 实现 有 上 百 种 ， 语 法 各 不 
相同 。Creole 试 图 建立 统一 的 维基 语法 标准 。 网 址 : http://www.wikicreole.org/， 以 及 可 作为 
DocBook(DocBook 是 着 名 的 用 于 文档 撰写 的 标记 语言 ， 采 用 XML 文 件 格 式 及 大 量 的 面向 出 版 
的 格式 标签 ， 能 够 实现 单一 源 文件 出 版 (Single-Source Publishing) ， 即 一 次 撰写 多 种 格式 
输出 (Write once, publish many) 。 但 复杂 的 XML 标签 给 写作 过 程 带 来 不 小 的 负担 。 网 

Ab : http://www.docbook.org/ 前 端的 颇 有 前 途 的 AsciiDoc(AsciiDoc 的 轻 量 级 标签 和 DocBook 的 
XML 标签 语法 有 着 清晰 的 对 应 关系 ， 既 解决 了 DocBook 语 言 标 签 复杂 、 难 读 难 写 的 问题 ， 又 
可 利用 DocBook 丰 富 的 工具 链 实现 单 一 源 文 件 向 多 种 格式 的 输出 转换 。 网 
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Ab : http://www.methods.co.nz/asciidocts 2578 & ° 


下 面 通过 一 张 表格 对 几 种 常用 的 轻 量 级 标记 语言 加 以 对 照 ， 供 有 不 同 标记 语言 偏好 的 用 户 参 
考 ， 便 于 在 GitHub 某 些 不 能 随意 更 换 标 记 语言 而 只 能 使 用 GFM (GitHub 风 格 的 Markdown ) 
的 场合 可 以 自如 地 转换 。 


详细 对 照 请 参考 原文 


页 献 者 列表 


Git 和 GitHub 促 进 了 开源 软件 的 发 展 是 因为 消除 了 核心 开发 者 和 贡献 者 的 隔 六 你 若 能 看 到 
代码 ， 你 就 能 改进 代码 。 开 放 的 电子 书 亦 是 如 此 ， 下 面 的 贡献 者 让 本 书 变 得 更 好 。 





以 贡献 时 间 为 序 ， 感 谢 : 


1. Zhang Hailong 报告 文字 错误 。 问 题 : #2 。 
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3. windwiny 纠正 文字 错误 。 提 交 : 1ed1a51 


